ログイン

ポート更新

Description

ポートの設定を更新(変更)します。

指定したパラメータの値のみ更新(変更)されます。

Request URL

Network API

PUT /v2.0/ports/{portid}

Request Json

・セキュリティグループの場合

{
  "port": {
    "security_groups": [
      "セキュリティグループID"
    ]
  }
}

・IPアドレスならびにセキュリティグループの場合

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

・全パラメータ指定の場合

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

Request Parameters

Parameter Value Style Description
X-Auth-Token トークン header トークンの情報を指定します。
トークンの発行方法は、トークン発行 にてご確認ください。
portid ポートID path ポートIDを指定します。
ポートIDの確認方法は、ポート一覧取得 を実行の上、レスポンス結果から対象ポートのポートIDをご確認ください。
ip_address
(Optional)		 IPアドレス body 対象のサブネットから割り当てたいIPアドレスを指定します。
subnet_id
(Optional)		 サブネットID body 割り当てたいIPアドレスのサブネットIDを指定します。サブネットIDの確認方法は、サブネット一覧取得 を実行の上、レスポンス結果から対象サブネットのサブネットIDをご確認ください。
security_groups
(Optional)		 セキュリティグループID body セキュリティグループIDを指定します。セキュリティグループIDの確認方法は、セキュリティグループ一覧取得 を実行の上、レスポンス結果から対象セキュリティグループのセキュリティグループIDをご確認ください。
allowed_address_pairs
(Optional)		 ネットワークアドレス body VIPとして利用する際にIPアドレスを指定します。CIDR形式(XXX.XXX.XXX.X/XX)でネットワークアドレスを指定する必要があります。
ローカルネットワークのみ指定可能です。

Response Code

Success 

200

Example

Request 

curl -X PUT \
-H "Accept: application/json" \
-H "X-Auth-Token: トークン" \
-d '{"port": {"security_groups": ["セキュリティグループID"]}}' \
https://networking.c3j1.conoha.io/v2.0/ports/ポートID

Response 

{
	"port": {
		"id": "ポートID",
		"name": "local-gnct24510032",
		"network_id": "ネットワークID",
		"tenant_id": "テナントID",
		"mac_address": "**:**:**:**:**:**",
		"admin_state_up": true,
		"status": "DOWN",
		"device_id": "",
		"device_owner": "",
		"fixed_ips": [
			{
				"subnet_id": "サブネットID",
				"ip_address": "10.0.0.1"
			}
		],
		"project_id": "テナントID",
		"security_groups": [
			"セキュリティグループID"
		],
		"allowed_address_pairs": [],
		"extra_dhcp_opts": [],
		"binding:vnic_type": "normal"
	}
}

ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。