Description

追加IPアドレス用のポートを作成します。

Request URL

Network API

POST /v2.0/allocateips

Request Json

セキュリティグループ指定なし

{
  "allocateip": {
    "count": 個数
  }
}

セキュリティグループ指定あり

{
  "allocateip": {
    "count": 個数,
    "security_groups": [
      "セキュリティグループID"
    ]
  }
}

Request Parameters

Parameter Value Style Description
X-Auth-Token トークン header トークンの情報を指定します。
トークンの発行方法は、トークン発行 にてご確認ください。
count 1~16 body 追加するIPアドレスの個数を指定します。1個から16個まで指定が可能です。
security_groups
(Optional)
セキュリティグループID body セキュリティグループIDを指定します。未指定の場合は、「default」のセキュリティグループが設定されます。
セキュリティグループIDの確認方法は、セキュリティグループ一覧取得 を実行の上、レスポンス結果から対象セキュリティグループのセキュリティグループIDをご確認ください。

Response Code

Success

201

Example

Request

curl -X POST \
-H "Accept: application/json" \
-H "X-Auth-Token: トークン" \
-d '{"allocateip": {"count": 個数}}' \
https://networking.c3j1.conoha.io/v2.0/allocateips

Response

{
	"port": {
		"id": "ポートID",
		"name": "add-i_100000-o_100000-p_0a",
		"network_id": "fb00d078-8ae1-4145-b3b9-82dfb7596227",
		"tenant_id": "テナントID",
		"mac_address": "**:**:**:**:**:**",
		"admin_state_up": true,
		"status": "DOWN",
		"device_id": "",
		"device_owner": "",
		"fixed_ips": [
			{
				"subnet_id": "サブネットID",
				"ip_address": "XXX.XXX.XXX.XXX"
			}
		],
		"project_id": "テナントID",
		"security_groups": [
			"セキュリティグループID"
		],
		"allowed_address_pairs": [],
		"extra_dhcp_opts": [],
		"binding:vnic_type": "normal"
	}
}

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