ポート作成

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) サブネットID
IPアドレス
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/0
mac_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": ""
   }
}

Internet for everyone

Copyright (c) 2024 GMO Internet Group, Inc. All Rights Reserved.