ログイン

ポート作成（ローカルネットワーク用）

Description

ローカルネットワーク用のポートを作成します。

ポートを作成するには、予めローカルネットワーク用のサブネットが作成されている必要があります。

Request URL

Network API

POST /v2.0/ports

Request Json

・IPアドレス指定あり ならびに セキュリティグループ指定なし

{
  "port": {
    "network_id": "ネットワークID",
    "fixed_ips": [
      {
        "ip_address": "IPアドレス",
        "subnet_id": "サブネットID"
      }
    ]
  }
}

・IPアドレス指定あり セキュリティグループ指定あり

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

・IPアドレス指定あり セキュリティグループ複数指定

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

・IPアドレス自動割り当て ならびに セキュリティグループ指定なし

{
  "port": {
    "network_id": "ネットワークID"
  }
}

・IPアドレス複数指定あり ならびに セキュリティグループ指定なし

{
  "port": {
    "network_id": "ネットワークID",
    "fixed_ips": [
      {
        "ip_address": "IPアドレス",
        "subnet_id": "サブネットID"
      },
      {
        "ip_address": "IPアドレス",
        "subnet_id": "サブネットID"
      }
    ]
  }
}

・IPアドレス複数自動割り当て ならびに セキュリティグループ指定なし

{
  "port": {
    "network_id": "ネットワークID",
    "fixed_ips": [
      {
        "subnet_id": "サブネットID"
      },
      {
        "subnet_id": "サブネットID"
      }
    ]
  }
}

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

{
  "port": {
    "network_id": "ネットワークID",
    "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 トークンの情報を指定します。
トークンの発行方法は、トークン発行 にてご確認ください。
network_id ネットワークID body ネットワークIDを指定します。ネットワークIDの確認方法は、ネットワーク一覧取得 を実行の上、レスポンス結果から対象ネットワークのネットワークIDをご確認ください。
ip_address IPアドレス body 対象のサブネットから割り当てたいIPアドレスを指定します。
subnet_id サブネットID body 割り当てたいIPアドレスのサブネットIDを指定します。サブネットIDの確認方法は、サブネット一覧取得 を実行の上、レスポンス結果から対象サブネットのサブネットIDをご確認ください。
security_groups
(Optional)		 セキュリティグループID body セキュリティグループIDを指定します。未指定の場合は、「default」のセキュリティグループが設定されます。
セキュリティグループIDの確認方法は、セキュリティグループ一覧取得 を実行の上、レスポンス結果から対象セキュリティグループのセキュリティグループIDをご確認ください。
allowed_address_pairs
(Optional)		 ネットワークアドレス body VIPとして利用する際にIPアドレスを指定します。CIDR形式(XXX.XXX.XXX.X/XX)でネットワークアドレスを指定する必要があります。

Response Code

Success 

201

Example

Request 

curl -X POST \
-H "Accept: application/json" \
-H "X-Auth-Token: トークン" \
-d '{"port": {"network_id": "ネットワークID","fixed_ips": [{"ip_address": "IPアドレス","subnet_id": "サブネットID"}],"security_groups": ["セキュリティグループID"]}}' \
https://networking.c3j1.conoha.io/v2.0/ports

Response 

{
	"port": {
		"id": "ポートID",
		"name": "local-gnct24510032",
		"network_id": "3c01d6c1-dad0-4994-a416-71d30cf02297",
		"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のドキュメントにてご確認ください。