ポート更新

Description

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

fixed_ipsパラメータについて

fixed_ips に指定する ip_address や subnet_id は、パラメータに指定した network_id に属するサブネットのものを指定する必要があります。
fixed_ips には複数のパラメータを指定することができます。
fixed_ips について、同一ネットワークのサブネットを複数所有している場合はサブネットが異なっても、ネットワークが同一のため、fixed_ips に指定することができます。

allowed_address_pairsパラメータについて

・	仮想サーバー用グローバルIPアドレス(Public)の場合
	指定するip_addressは自分の所有するグローバルIPアドレスである必要があります。
	複数のallowed_address_pairを指定可能です。

・	アプライアンス型ロードバランサー(LBNAT), プライベートネットワーク(VLanLocal), 専用グローバルIPアドレス(Dedicated)の場合
	指定可能なip_addressは、“0.0.0.0/0” のみとなります。
	ip_addressが未指定の場合は "0.0.0.0/0" が自動で設定されます。
	mac_addressを指定することもできます。

security_groupsパラメータについて

Defaultのセキュリティグループはデタッチすることができます。
セキュリティグループを全てデタッチすることはできません。

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": "IPアドレス"
            },
            {
                "ip_address": "IPアドレス"
            }
        ],
        "security_groups": [
            "セキュリティグループID",
            "セキュリティグループID"
        ]
    }
}

Request Parameters

Parameter	Value	Style	Description
X-Auth-Token	トークンID	header	トークン発行にて払い出されたID
port_id	ポートID	URI	ポート一覧取得にて対象のポートIDをご確認ください。
security_groups (Optional)	セキュリティグループID	plain	セキュリティグループIDを指定します。指定がない場合は「Default」のセキュリティグループが設定されます。
fixed_ips (Optional)	サブネットID IPアドレス	plain	特定のサブネットやIPアドレスを指定したい時に利用します。
allowed_address_pairs (Optional)	IPアドレス 0.0.0.0/0 mac_address	plain

Response

Normal response codes

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"
            ]
        }
    }' \
ネットワークエンドポイント/ports/ポートID

Response

HTTP/1.1 200 OK
Date: Fri, 30 Mar 2018 14:48:36 GMT
Server: Apache
Content-Length: 751
Content-Type: application/json

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