Show port

指定したポートの情報を表示します。

URI

/v2.0/ports/{port_id}

URIの説明：

ポートID

HTTPメソッド

GET

レスポンスステータス

ステータスコード 説明
200 Normal response codes
unauthorized (401) Error response codes
itemNotFound (404) Error response codes

レスポンスボディ(正常系)


{
    "port": {
        "status": "ACTIVE",
        "name": "",
        "allowed_address_pairs": [],
        "admin_state_up": true,
        "network_id": "a87cc70a-3e15-4acf-8205-9b711a3531b7",
        "tenant_id": "7e02058126cc4950b75f9970368ba177",
        "extra_dhcp_opts": [],
        "device_owner": "network:router_interface",
        "mac_address": "fa:16:3e:23:fd:d7",
        "binding:vnic_type": "normal",
        "fixed_ips": [
            {
                "subnet_id": "a0304c3a-4f08-4c43-88af-d796509c97d2",
                "ip_address": "10.0.0.1"
            }
        ],
        "id": "46d4bfb9-b26e-41f3-bd2e-e6dcc1ccedb2",
        "security_groups": [],
        "device_id": "5e3898d7-11be-483e-9732-b2f5eccd2b2e",
        "availability_zone": "AZ1"
    }
}

レスポンスボディ(正常系)の説明

要素名 説明
status ポートのステータス

値は"ACTIVE"または"DOWN"です
name ポート名
allowed_address_pairs 通信を許可したアドレスペアリスト
admin_state_up ポートの管理状態

ポートが稼動中(true)か停止している(false)かを示します。
network_id アタッチされているネットワークのID
tenant_id ネットワークを所有しているプロジェクトID
extra_dhcp_opts 追加のDHCPオプション
device_owner このポートを使用するエンティティのID

例: DHCPエージェント
mac_address ポートのMACアドレス
fixed_ips ポートのIPアドレス

IPアドレスとサブネットIDが含まれます。
id ポートID
security_groups アタッチされているセキュリティグループのID
device_id このポートを使用するデバイスのID

例: 仮想サーバ
binding:vnic_type ポートに紐付けられている仮想NIC種別。

値は次のいずれかです。

  • normal(仮想NIC)
  • direct(PCIパススルー)
  • macvtap(TAPに似たソフトウェアインターフェースを持つ仮想インターフェース)
availability_zone アベイラビリティゾーン名