ユーザーガイド/リファレンスガイド

ポート更新

Description

ポートの設定を更新(変更)します。
Nameの変更を行うことはできません。
指定したパラメータの値のみ更新されます。

Request URL

Network API v2.0
PUT /v2.0/ports/{port_id}

Request Json

{
    “port”: {
        “fixed_ips”: [
            {
                “ip_address”: “IPアドレス“,
                “subnet_id”: “サブネットID
            },
            {
                “ip_address”: “IPアドレス“,
                “subnet_id”: “サブネットID
            }
        ],
        “allowed_address_pairs”: [
            {
                “ip_address”: “VIP
            },
            {
                “ip_address”: “VIP
            }
        ],
        “security_groups”: [
            “セキュリティグループID“,
            “セキュリティグループID
        ]     }
}

Request Paramters

Parameter Value Style Description
X-Auth-Token Userトークン header トークンID
port_id ポートID URI ポートIDを指定します。
security_groups (Optional) セキュリティグループID plain セキュリティグループIDを指定します。
指定がない場合は「Default」のセキュリティグループが設定されます。
fixed_ips (Optional) サブネットID
IPアドレス
plain 特定のサブネットやIPアドレスを指定したい時に利用します。
subnet_id (Optional) サブネットID plain fixed_ips パラメータにて、特定のサブネットを指定したい時にサブネットIDを指定します。
ip_address (Optional) IPアドレス plain fixed_ips パラメータにて、特定のIPアドレスを指定したい時に指定します。
allowed_address_pairs (Optional)   plain DSR LBのVIPを利用する際に指定します。

指定したネットワークによって受け入れるパラメータが異なります。

  Public Additional NAT LB VLAN Dedicated
security_groups Optional Optional Optional Optional
fixed_ips Optional Optional Optional Optional Optional
allowed_address_pairs Optional Optional

Response

Normal response codes

200

Example

Request

curl -i -X PUT \
-H “Accept: application/json” \
-H “Content-Type: application/json” \
-H “X-Auth-Token: トークンID” \
-d ‘{
        “port”: {
            “fixed_ips”: [
                {
                    “ip_address”: “IPアドレス“,
                    “subnet_id”: “サブネットID
                },
                {
                    “ip_address”: “IPアドレス“,
                    “subnet_id”: “サブネットID
                }
            ],
            “security_groups”: [
                “セキュリティグループID“,
                “セキュリティグループID
            ]         }
    }’ \
https://networking.odc01.eva-clouds.com/v2.0/ports/ポートID

Response

HTTP/1.1 200 OK
Date: Mon, 25 Jul 2016 08:00:32 GMT
Server: Apache
Content-Length: 691
Content-Type: application/json

{
    “port”: {
        “admin_state_up”: true,
         “allowed_address_pairs”: [],
         “binding:vnic_type”: “normal”,
         “device_id”: “”,
         “device_owner”: “”,
         “extra_dhcp_opts”: [],
         “fixed_ips”: [
            {
                “ip_address”: “IPアドレス“,
                 “subnet_id”: “サブネットID
            },
             {
                “ip_address”: “IPアドレス“,
                 “subnet_id”: “サブネットID
            }
        ],
         “id”: “ポートID“,
         “mac_address”: “MACアドレス“,
         “name”: “ポートの名前“,
         “network_id”: “ネットワークID“,
         “security_groups”: [
            “セキュリティグループID“,
             “セキュリティグループID
        ],
         “status”: “DOWN”,
         “tenant_id”: “テナントID
    }
}