検討中のお客様はこちら

0120-50-6065

10:00〜19:00
土日祝、年末年始除く

お申し込み

ポート更新

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) サブネット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を利用する際に指定します。

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.gpu-sys.cloud/v2.0/ports/ポートID
  • Response
HTTP/1.1 200 OK
Date: Sun, 30 Aug 2020 14:51:26 GMT
Server: Apache
Content-Length: 565
Content-Type: application/json

{
  "port": {
    "status": "DOWN",
    "name": "ポートの名前",
    "allowed_address_pairs": [],
    "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": ""
  }
}