Show trunk details#

ポートとそのトランクの詳細を表示します。

APIエンドポイント#

リージョン	APIエンドポイント
西日本リージョン3の場合	https://networking.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合	https://networking.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI#

GET

/v2.0/ports/{port_id}

HTTPステータスコード#

正常時：200

リクエストパラメータの説明#

名前	In	Type	デフォルト値 /必須指定	Description
port_id	path	string	必須	ポートのID

レスポンスボディ（正常系）の説明#

名前	Type	Description
status	string	ポートのステータス「ACTIVE」、「DOWN」、「BUILD」または「ERROR」のどれかが表示されます。
created_at	string	リソースの作成日時
description	string	リソースの説明
admin_state_up	boolean	リソースの管理状態「up(true)」または「down(false)」が表示されます。
network_id	string	ネットワークのID
project_id	string	プロジェクトのID
tenant_id	string	プロジェクトのID
extra_dhcp_opts	array	DHCPオプションの「opt_value」と「opt_name」のペア extra_dhcp_optsはportのDHCP optionに対して、拡張するパラメータです。例えば、portのtftp-server、DNS-serverなど設定できます。 - opt_name DHCPの特定オプション指定されたオプションはポートに反映されます例：bootfile-name, server-ip-address, tftp-server - opt_value 「opt_name」の属性の値例： - `"extra_dhcp_opts":[{"opt_value":"0","opt_name":"router"}]` GatewayのDefault Routeの取得を禁止します。 - `"extra_dhcp_opts": [{"opt_value": "{dns_server}", "opt_name": "dns-server"}]` 仮想サーバに対して固定でDNSのアドレスを設定します。 extra_dhcp_optsのオプションはDHCPプロトコルのオプションと同じです。 DHCPプロトコルのオプションの詳しい情報は以下を参照してください。 http://tools.ietf.org/html/rfc2132
updated_at	string	ポートの更新日時
name	string	リソース名
device_owner	string	このポートを使用するエンティティのID
trunk_details	array	トランクの詳細情報
trunk_id	string	トランクのID
sub_ports	array	トランクと関連つけられているポートの一覧
segmentation_id	integer	ポートのセグメンテーションID
port_id	string	ポートのID
segmentation_type	string	セグメンテーションタイプ「vlan」または「inherit」が表示されます。「inherit」の場合は、ポートが接続するネットワークにセグメンテーションタイプを引き継ぎます。
mac_address	string	ポートのMACアドレス
revision_number	integer	リソースの改訂番号
fixed_ips	array	ポートのIPアドレス各項目にIPアドレスとサブネットのIDが入っています。
id	string	リソースのID
security_groups	array	ポートに適用されているセキュリティグループのID
device_id	string	このポートを使用するデバイスのID

レスポンス例#

{
    "port": {
        "status": "DOWN",
        "created_at": "2016-10-05T20:05:14Z",
        "description": "",
        "admin_state_up": true,
        "network_id": "1cf9e069-365f-4a78-8784-616bc12c4c5a",
        "project_id": "313be01bd0744cea86643c711c57012b",
        "tenant_id": "313be01bd0744cea86643c711c57012b",
        "extra_dhcp_opts": [],
        "updated_at": "2016-10-05T20:05:14Z",
        "name": "test",
        "device_owner": "",
        "trunk_details": {
            "trunk_id": "8905d084-010c-46e8-a863-f21cb4441ab1",
            "sub_ports": [
               {
                   "segmentation_id": 33,
                   "port_id": "70df9f3e-b409-4761-8304-ce029b2079f5",
                   "segmentation_type": "vlan",
                   "mac_address": "fa:16:3e:86:9b:dc"
               },
               {
                   "segmentation_id": 44,
                   "port_id": "4b4c691b-086d-43d2-8a65-5487e9434155",
                   "segmentation_type": "vlan",
                   "mac_address": "fa:16:3e:fe:29:97"
               }
           ]
       },
       "revision_number": 5,
       "mac_address": "fa:16:3e:5c:e9:a3",
       "fixed_ips": [
           {
               "subnet_id": "76a059c0-b189-479f-882c-5e8bd464ea49",
               "ip_address": "40.0.0.3"
           }
       ],
       "id": "8027c4da-772f-4e43-bfbf-023b4a4e63de",
       "security_groups": ["da88a249-12ac-4221-9565-c406b6feeb48"],
       "device_id": ""
    }
}