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