ポート更新
Description
ポートの設定を更新(変更)します。
Nameの変更を行うことはできません。
指定したパラメータの値のみ更新されます。
fixed_ipsパラメータについて
- fixed_ips に指定する ip_address や subnet_id は、パラメータに指定した network_id に属するサブネットのものを指定する必要があります。
- fixed_ips には複数のパラメータを指定することができます。
- fixed_ips について、同一ネットワークのサブネットを複数所有している場合はサブネットが異なっても、ネットワークが同一のため、fixed_ips に指定することができます。
allowed_address_pairsパラメータについて
- [Public, Additionalのネットワークの場合]
- 指定するip_addressは自分の所有するVIPである必要があります。
- 複数のallowed_address_pairを指定可能です。
- [LBNAT, VLanLocal, Dedicatedのネットワークの場合]
- 指定可能なip_addressは "0.0.0.0/0" のみとなります。
- ip_addressが未指定の場合は "0.0.0.0/0" が自動で設定されます。
- "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": "VIP" }, { "ip_address": "VIP" } ], "security_groups": [ "セキュリティグループID", "セキュリティグループID" ] } }
Request Parameters
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) | サブネットIDIPアドレス | 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を利用する際に指定します。 |
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.jpt1.cloud.z.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" } }