A virtual cable (vCable) is an internal representation of the link between an instance's network interface and a specific network. A vCable is created automatically when an instance is launched and is deleted when the instance is deleted. When a vCable is deleted (on instance termination), entities that depend on them are also deleted.
Topics:
This command enables you to discover a list of vCables configured in a specific container.
Syntax
oracle-compute discover vcable container
Parameters and Options
The following parameters are specific to this command. You can also use the common options described in General Command Options.
| Parameter | Description |
|---|---|
| container | Hierarchical name-space for vCables. For example, /mytenant/public/myvcable |
Example
$ oracle-compute discover vcable /mytenant/public
Sample Output
$ oracle-compute discover vcable /mytenant/public entry /mytenant/public/01cb8de3-945f-41b3-8e76-206c0a17c770 /mytenant/public/030e87f3-b7aa-423b-83ee-c30bbfd2e8a0 /mytenant/public/06200aa6-3284-4320-a8dc-fbc001e8ace8 /mytenant/public/0973a377-1542-440b-bf9b-8c8e14b93586 /mytenant/public/1117e4b7-25b1-4796-b37d-119a623304b9 /mytenant/public/15e1b187-d739-4d95-9a71-0235774e6779 /mytenant/public/1d361020-f6a2-4deb-9e2b-d5fd0a5444aa /mytenant/public/1e917354-2858-425c-b92f-8a77ef7b8532 /mytenant/public/2036c074-89f9-4880-a498-d23ba95c6d04 /mytenant/public/265d1044-ca53-441d-bcf9-afb9a2070bcf /mytenant/public/2cbd35fb-05bc-45e7-b194-5b508d669258 /mytenant/public/2e63136b-7989-426d-93a3-8c63cf5d9e54 /mytenant/public/302b8248-0fd0-42c7-9776-6c248692854d /mytenant/public/32b4c1b1-85c0-4aa7-9766-431ea2fa40a9 /mytenant/public/3f4647b2-d49d-458e-9a82-253fc22403d9
This command enables you to retrieve information for a specific vCable.
Syntax
oracle-compute get vcable id
Parameters and Options
The following parameters are specific to this command. You can also use the common options described in General Command Options.
| Parameter | Description |
|---|---|
| id | Unique Id of vCable |
Example
$ oracle-compute get vcable /mytenant/public/f818e9bb-251f-476a-aa36-08e8fc6f7707
Sample Output
$ oracle-compute get vcable /mytenant/public/f818e9bb-251f-476a-aa36-08e8fc6f7707 -F id,vethernet id vethernet /mytenant/public/f818e9bb-251f-476a-aa36-08e8fc6f7707 /cloud/public/IPoIB-instance-storage $
This command enables you to retrieve information for vCables in a specific container.
Syntax
oracle-compute list vcable container [--vnet] [--vethernet_id] [--vethernet_type] [--id] [--instance] [--vethernet]
Parameters and Options
The following parameters are specific to this command. You can also use the common options described in General Command Options.
| Parameter | Description |
|---|---|
| container | Hierarchical name-space for vCables. For example, /mytenant/public/myvcable |
| --vnet | (Optional) The path of the vNET used to create the vCable.
If specified, the vCable listing is scoped to only include vCables linked to the specified vNET. |
| --vethernet_id |
(Optional) The vEthernet Id for the vCable. If specified, the vCable listing is scoped to only include vCables with the specified Id. The parameter is always set to -1 for infiniband networks. |
| --vethernet_type | (Optional) The type of vEthernet for the vCable. Possible values are ipoib or eoib.
If specified, the vCable listing will be scoped to only include vCables linked to vEthernets of the specified type. |
| --id |
(Optional) Unique identifier of the particular vCable for which you want to retrieve info. |
| --instance | (Optional) A specific instance you want to list vCables for.
If specified, the listing will be scoped to only include vCables linked to this specific instance. |
| --vethernet | (Optional) The path of the vEthernet used to create the vCable.
If specified, the listing will be scoped to only include vCables linked to this specific vEthernet. |
Example
$ oracle-compute list vcable /mytenant/public/
Sample Output
oracle-compute list vcable /mytenant/public -Fname,id,address -ftab --instance /mytenant/public/e6a987d4-2ca6-4edb-926a-89858ecc82a9 id address /mytenant/public/2d4ac3e8-4f5f-4081-a5eb-67a7a5b0c3f8 00:21:f6:b5:19:52, 00:21:f6:75:c6:7d, 10.247.64.56 /mytenant/public/b1658206-709a-4bcc-9adb-e173ec1d3634 None, 10.196.0.11 /mytenant/public/fe0598d2-be48-4f0a-a9d0-5286df80300a None, 192.168.128.25