ポート更新

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

9月 8,2017 コメントを受け付けていません。 By spttec

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“
}
}