List ports

プロジェクトが利用できるポートを一覧表示する。

URI

/v2.0/ports

HTTPメソッド

GET

レスポンスステータス

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

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


{
    "ports": [
        {
            "status": "ACTIVE",
            "name": "",
            "allowed_address_pairs": [],
            "admin_state_up": true,
            "network_id": "70c1db1f-b701-45bd-96e0-a313ee3430b3",
            "tenant_id": " d397de8a63f341818f198abb0966f6f3",
            "extra_dhcp_opts": [],
            "device_owner": " network:router_interface ",
            "mac_address": "fa:16:3e:58:42:ed",
            "binding:vnic_type": "normal",
            "fixed_ips": [
                {
                    "subnet_id": "008ba151-0b8c-4a67-98b5-0d2b87666062",
                    "ip_address": "172.24.4.2"
                }
            ],
            "id": "d80b1a3b-4fc1-49f3-952e-1e2ab7081d8b",
            "security_groups": [],
            "device_id": "9ae135f4-b6e0-4dad-9e91-3c223e385824",
            "availability_zone": "AZ1"
        },
        {
            "status": "ACTIVE",
            "name": "",
            "allowed_address_pairs": [],
            "admin_state_up": true,
            "network_id": "f27aa545-cbdd-4907-b0c6-c9e8b039dcc2",
            "tenant_id": "d397de8a63f341818f198abb0966f6f3",
            "extra_dhcp_opts": [],
            "device_owner": "network:router_interface",
            "mac_address": "fa:16:3e:bb:3c:e4",
            "binding:vnic_type": "normal",
            "fixed_ips": [
                {
                    "subnet_id": "288bf4a1-51ba-43b6-9d0a-520e9005db17",
                    "ip_address": "10.0.0.1"
                }
            ],
            "id": "f71a6703-d6de-4be1-a91a-a570ede1d159",
            "security_groups": [],
            "device_id": "9ae135f4-b6e0-4dad-9e91-3c223e385824",
            "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 (Optional) ポートに紐付けられている仮想NIC種別。

値は次のいずれかです。

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