vCableの表示

仮想ケーブル(vCable)は、インスタンスのネットワーク・インタフェースと特定ネットワークの間のリンクの内部表現です。 vCableは、インスタンスを起動すると自動的に作成され、インスタンスを削除すると削除されます。 vCableが(インスタンスの終了で)削除されると、それらに依存するエンティティも削除されます。

トピック:

vCableの検出

このAPIを使用すると、特定のコンテナ内のvCableオブジェクトを検出できます。

注意:

検出APIコールは、指定されたコンテナ内のオブジェクトの名前を表示しますが、オブジェクトの詳細は表示しません。オブジェクトの名前をリストするには、Acceptヘッダーをapplication/oracle-compute-v3+directory+jsonに設定します。その他の目的では、Acceptヘッダーをapplication/oracle-compute-v3+jsonに設定する必要があります。

メソッド

GET

RESTリソース

/vcable/container/

URI

https://api_endpoint/vcable/container/

URIパラメータ

パラメータ	説明
container	vCableの階層名前空間。たとえば、`/mytenant/public/myvcable`です

URIの例

http://api.oc.example.com/vcable/mytenant/public

レスポンス本文の例

{
    "result": [
        "/mytenant/public/450e9885-42a0-44ec-b102-9bbaf9c2c1e0",
        "/mytenant/public/c65ccbbd-80b1-40c5-a100-356434c17374",
        "/mytenant/public/dca6695a-7b72-49cb-9a70-20369b24a3d5",
        "/mytenant/public/e8ec90f9-95a0-444f-bafe-ec5c87518d77"
    ]
}

vCableの取得

このAPIを使用すると、特定のvCableの情報を取得できます。

メソッド

GET

RESTリソース

/vcable/name

URI

https://api_endpoint/vcable/name

URIパラメータ

パラメータ	説明
name	vCableの名前。

URIの例

http://api.oc.example.com/vcable/mytenant/public/450e9885-42a0-44ec-b102-9bbaf9c2c1e0

レスポンス本文の例

{
 "net_config": 
 {
  "owner": {"type": "tenant", "name": "mytenant"}, 
  "ip": "192.168.160.67", 
  "netmask": "255.255.255.192", 
  "type": "IPoIB"
 }, 
 "vethernet_id": "-1", 
 "vnetreservation": "/mytenant/public/vnetres2", 
 "uri": "http://api.oc.example.com/vcable/mytenant/public/450e9885-42a0-44ec-b102-9bbaf9c2c1e0", 
 "options": {}, 
 "instance": "/mytenant/public/32970825-74b9-4a19-aa84-570eabed8325", 
 "vnet": "/mytenant/public/IPoIB-Test", 
 "vethernet": "/mytenant/public/default", 
 "address": [null, "192.168.160.67"], 
 "model": "", 
 "vethernet_type": "ipoib",  
 "id": "/mytenant/public/450e9885-42a0-44ec-b102-9bbaf9c2c1e0", 
 "dhcp_options": []
}

vCableのリスト

このAPIを使用すると、特定のコンテナ内のvCableの情報を取得できます。

メソッド

GET

RESTリソース

/vcable/container/

URI

https://api_endpoint/vcable/container?vnet=vnetValue&vethernet_id=vethrenet_idValue&vethernet_type=vethernet_typeValue&id=idvalue&instance=instanceValue&vethernet=vethernetValue

URIパラメータ

パラメータ	説明
container	vCableの階層名前空間。たとえば、`/mytenant/public/myvcable`です
vnet=vnetValue	(オプション) vCableの作成に使用されるvNETのパス。指定されている場合、vCableのリストは、指定されたvNETにリンクされたvCableのみを含むように範囲指定されます。
vethernet_id=vethernet_idValue	(オプション) vCableのvEthernet ID。指定されている場合、vCableのリストは、指定されたIDを持つvCableのみを含むように範囲指定されます。パラメータは、常に、infinibandネットワークに対して-1に設定されます。
vethernet_type=vethernet_typeValue	(オプション) vCableのvEthernetタイプ。指定可能な値は、`ipoib`または`eoib`です。指定されている場合、vCableのリストは、指定されたタイプのvEthernetにリンクされたvCableのみを含むように範囲指定されます。
id=idValue	(オプション)情報を取得する特定のvCableの一意の識別子。
instance=instanceValue	(オプション) vCableをリストする特定のインスタンス。指定されている場合、リストは、この特定のインスタンスにリンクされたvCableのみを含むように範囲指定されます。
vethernet=vethernetValue	(オプション) vCableの作成で使用するvEthernetのパス。指定されている場合、リストは、この特定のvEthernetにリンクされたvCableのみを含むように範囲指定されます。

URIの例

https://api.oc.example.com/vcable/mytenant/?vethernet=/oracle/public/default

レスポンス本文の例

{
 "result": 
  [{
   "vethernet_id": "0", 
   "uri": "http://api.oc.example.com/vcable/mytenant/public/06202d2e-3c30-42ca-974f-61cfdeb37120", 
   "proxyuri": null, 
   "instance": "/mytenant/public/917385c0-7951-4463-bafa-d817b9174bf5", 
   "vethernet": "/oracle/public/default", 
   "address": ["c6:b0:3a:0a:bf:6c", "0.0.0.0"], 
   "model": "", 
   "vethernet_type": "vlan", 
   "id": "/mytenant/public/06202d2e-3c30-42ca-974f-61cfdeb37120"
 }]
}