ポート作成
Description
ポートを作成します。
fixed_ipsパラメータについて
- fixed_ips に指定する ip_address や subnet_id は、パラメータに指定した network_id に属するサブネットのものを指定する必要があります。
- fixed_ips には複数のパラメータを指定することができます。
- fixed_ips について、同一ネットワークのサブネットを複数所有している場合はサブネットが異なっても、ネットワークが同一のため、fixed_ips に指定することができます。
allowed_address_pairsパラメータについて
・ | 仮想サーバー用グローバルIPアドレス(Public)の場合 |
指定するip_addressは自分の所有するグローバルIPアドレスである必要があります。 | |
複数のallowed_address_pairを指定可能です。 |
・ | アプライアンス型ロードバランサー(LBNAT), プライベートネットワーク(VLanLocal), 専用グローバルIPアドレス(Dedicated)の場合 |
指定可能なip_addressは、“0.0.0.0/0” のみとなります。 | |
ip_addressが未指定の場合は "0.0.0.0/0" が自動で設定されます。 | |
mac_addressを指定することもできます。 |
security_groupsパラメータについて
・ | defaultのセキュリティグループについて |
defaultのセキュリティグループには、n-defaultとl-defaultの2種類があります。 | |
ネットワークの種類によってdefaultで適用されるセキュリティグループは異なります。 |
セキュリティグループ名 | INPUT(受信) | OUTPUT(送信) |
---|---|---|
n-default | - | 全許可 |
l-default | 全許可 | 全許可 |
・ | 仮想サーバー用グローバルIPアドレス(Public), 専用グローバルIPアドレス(Dedicated)の場合 |
何も指定がない場合は、n-defaultのセキュリティグループが適用されます。 | |
n-default以外のセキュリティグループを指定した場合は、指定したセキュリティグループのみ適用されます。 |
・ | アプライアンス型ロードバランサー(LBNAT), プライベートネットワーク(VLanLocal)の場合 |
何も指定がない場合は、l-defaultのセキュリティグループが適用されます。 | |
l-default以外のセキュリティグループを指定した場合は、指定したセキュリティグループのみ適用されます。 |
・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 Parameters
Parameter | Value | Style | Description |
---|---|---|---|
X-Auth-Token | トークンID | header | トークン発行 にて払い出されたID |
network_id | ネットワークID | plain | ネットワーク一覧取得 にて対象のネットワークIDをご確認ください。 |
security_groups (Optional) | セキュリティグループID | plain | セキュリティグループIDを指定します。指定がない場合は「Default」のセキュリティグループが設定されます。 |
fixed_ips (Optional) | サブネットIDIPアドレス | plain | 特定のサブネットやIPアドレスを指定したい時に利用します。 |
subnet_id (Optional) | サブネットID | plain | fixed_ips パラメータにて、特定のサブネットを指定したい時にサブネットIDを指定します。subnet_id のみ指定した場合は、subnet 内のIPアドレスが自動で割り当てられます。サブネット一覧取得 にて対象のサブネットIDをご確認ください。 |
ip_address (Optional) | IPアドレス | plain | fixed_ips パラメータにて、特定のIPアドレスを指定したい時に指定します。 |
allowed_address_pairs (Optional) | IPアドレス0.0.0.0/0mac_address | plain |
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"}]}}' \ ネットワークエンドポイント/ports
-
Response
HTTP/1.1 201 Created
Date: Fri, 30 Mar 2018 11:57:08 GMT
Server: Apache
Content-Length: 603
Content-Type: application/json
{
"port": {
"status": "DOWN",
"name": "ネットワーク名",
"allowed_address_pairs": [
{
"ip_address": "0.0.0.0/0",
"mac_address": "MACアドレス"
}
],
"admin_state_up": true,
"network_id": "ネットワークID",
"tenant_id": "テナントID",
"binding:vnic_type": "normal",
"device_owner": "",
"mac_address": "MACアドレス",
"fixed_ips": [
{
"subnet_id": "サブネットID",
"ip_address": "IPアドレス"
}
],
"id": "ポートID",
"security_groups": [
"セキュリティグループID"
],
"device_id": ""
}
}