ポート作成

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

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

Description

ポートを作成します。
指定するnetwork_idが不明な場合は、「サブネット詳細取得」のAPIで確認できます。

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” のみとなります。
mac_addressを指定することもできます。

・subnet_idのみ指定する場合
“fixed_ips”: [
{
“subnet_id”: “サブネットID“
}
]

・ip_addressのみ指定する場合
“fixed_ips”: [
{
“ip_address”: “IPアドレス“
}
]

・fixed_ipsを複数指定する場合
“fixed_ips”: [
{
“ip_address”: “IPアドレス“
},
{
“ip_address”: “IPアドレス“
},
(snip)
{
“ip_address”: “IPアドレス“
}
]

Request URL

Network API v2.0
POST /v2.0/ports

Request Json

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

Request Paramters

Parameter	Value	Style	Description
X-Auth-Token	Userトークン	header	トークンID
network_id	ネットワークID	plain	ネットワークIDを指定します。
security_groups (Optional)	セキュリティグループID	plain	セキュリティグループIDを指定します。指定がない場合は「Default」のセキュリティグループが設定されます。
fixed_ips (Optional)	サブネットID IPアドレス	plain	特定のサブネットやIPアドレスを指定したい時に利用します。
subnet_id (Optional)	サブネットID	plain	fixed_ips パラメータにて、特定のサブネットを指定したい時にサブネットIDを指定します。 subnet_id のみ指定した場合は、subnet 内のIPアドレスが自動で割り当てられます。
ip_address (Optional)	IPアドレス	plain	fixed_ips パラメータにて、特定のIPアドレスを指定したい時に指定します。
allowed_address_pairs (Optional)		plain	DSR LBのVIPを利用する際に指定します。

指定したネットワークによって受け入れるパラメータが異なります。

	Public	Additional	NAT LB	VLAN	Dedicated
network_id	Required	Required	Required	Required	Required
security_groups	Optional	Optional	Optional	–	Optional
fixed_ips	Optional	Optional	Optional	Optional	Optional
allowed_address_pairs	Optional	Optional	Optional	Optional	Optional

Response

Normal response codes

201

Example

Request

curl -i -X POST \
-H “Accept: application/json” \
-H “Content-Type: application/json” \
-H “X-Auth-Token: トークンID” \
-d ‘{“port”:{“network_id”:”ネットワークID“,”fixed_ips”:[{“ip_address”:”IPアドレス“,”subnet_id”:”サブネットID“}]}}’ \
https://networking.odc01.eva-clouds.com/v2.0/ports

Response

HTTP/1.1 201 Created
Date: Mon, 25 Jul 2016 07:42:44 GMT
Server: Apache
Content-Length: 542
Content-Type: application/json

{
“port”: {
“admin_state_up”: true,
   “allowed_address_pairs”: [],
   “binding:vnic_type”: “normal”,
   “device_id”: “”,
   “device_owner”: “”,
   “fixed_ips”: [
{
“ip_address”: “IPアドレス“,
   “subnet_id”: “サブネットID“
}
],
   “id”: “ポートID“,
   “mac_address”: “MACアドレス“,
   “name”: “ポートの名前“,
   “network_id”: “ネットワークID“,
   “security_groups”: [
“セキュリティグループID“
],
   “status”: “DOWN”,
   “tenant_id”: “テナントID“
}
}