Create subnet#
ネットワークにサブネットを作成します。
APIエンドポイント#
| リージョン | APIエンドポイント |
|---|---|
| 西日本リージョン3の場合 | https://networking.jp-west-3.cloud.global.fujitsu.com |
| 東日本リージョン3の場合 | https://networking.jp-east-3.cloud.global.fujitsu.com |
HTTPメソッドとURI#
POST
/v2.0/subnets
HTTPステータスコード#
正常時：201
エラー時：400, 401, 403, 404, 409
リクエストパラメータの説明#
| 名前 | In | Type | デフォルト値 /必須指定 |
Description |
|---|---|---|---|---|
| subnet | body | string | 必須 | サブネットのオブジェクト |
| tenant_id | body | string | 任意 | リソースの所有者のプロジェクトID 管理者ユーザーだけは自分が所属するプロジェクト以外のプロジェクトIDを指定可能です。認証ポリシーでこのポリシーを変更することはできません。 |
| project_id | body | string | 任意 | リソースの所有者のプロジェクトID 管理者ユーザーだけは自分が所属するプロジェクト以外のプロジェクトIDを指定可能です。認証ポリシーでこのポリシーを変更することはできません。 |
| name | body | string | null 任意 |
リソース名 |
| enable_dhcp | body | boolean | true 任意 |
DHCPの有効／無効 |
| network_id | body | string | 必須 | リソースが所属するネットワークのID |
| dns_nameservers | body | array | [] 任意 |
サブネット用DNSネームサーバの一覧 例： ["8.8.8.7", "8.8.8.8"] 指定したIPアドレスは昇順にソートされた状態で表示されます。最後に表示されているIPアドレスがプライマリDNSアドレスです。 |
| allocation_pools | body | array | 任意 | 割り当てプールの開始アドレスと終了アドレス 省略する場合は、CIDR内のすべてのIPアドレスが自動的に割り当てられます。(サブネットゲートウェイ用のIPアドレスを除きます) |
| host_routes | body | array | 任意 | サブネット用のホストルート情報 📒注: ロードバランサー (lbaas)を配備するサブネットを作成する場合、作成されたロードバランサーにもこのホストルートの情報が反映されます。なお、ホストルートにデフォルトルートを設定しないでください。ロードバランサーと同一サブネット内にあるバックエンドの仮想サーバと通信できなくなります。 |
| destination | body | string | 必須 | 宛先のCIDR |
| nexthop | body | string | 必須 | 宛先に到達するために次に転送すべき隣接するIPアドレス 仮想ルータが接続しているサブネットに存在する必要があります。 |
| ip_version | body | integer | 必須 | IPバージョン 4を指定します。 |
| gateway_ip | body | string | 任意 | ゲートウェイのIPアドレス 「null」の場合は、ゲートウェイが関連付けられていません。省略する場合は、CIDR内の任意のIPアドレスが割り当てられます。 |
| cidr | body | string | 必須 | サブネットのCIDR |
| description | body | string | null 任意 |
リソースの説明 |
| subnetpool_id | body | string | 任意 | 関連付けられているサブネットプールのID |
| use_default_subnetpool | body | boolean | 任意 | サブネットをデフォルトのサブネットプールから割り当てるかどうかを表示します。 |
レスポンスボディ（正常系）の説明#
| 名前 | Type | Description |
|---|---|---|
| subnet | string | サブネットのオブジェクト |
| id | string | サブネットのID |
| tenant_id | string | プロジェクトのID |
| project_id | string | プロジェクトのID |
| name | string | リソース名 |
| enable_dhcp | boolean | DHCPの有効／無効 |
| network_id | string | リソースが所属するネットワークのID |
| dns_nameservers | array | サブネット用DNSネームサーバの一覧 例： ["8.8.8.7", "8.8.8.8"] 指定したIPアドレスは昇順にソートされた状態で表示されます。最後に表示されているIPアドレスがプライマリDNSアドレスです。 |
| allocation_pools | array | 割り当てプールの開始アドレスと終了アドレス |
| host_routes | array | サブネット用のホストルート情報 |
| destination | string | 宛先のCIDR |
| nexthop | string | 宛先に到達するために次に転送すべき隣接するIPアドレス 仮想ルータが接続しているサブネットに存在する必要があります。 |
| ip_version | integer | IPバージョン 4が表示されます。 |
| gateway_ip | string | ゲートウェイのIPアドレス 「null」の場合は、ゲートウェイが関連付けられていません。 |
| cidr | string | サブネットのCIDR |
| created_at | string | サブネットの作成日時 |
| description | string | リソースの説明 |
| ipv6_address_mode | string | IPv6のアドレスの割り当て方法 |
| ipv6_ra_mode | string | IPv6パケットを転送するかどうかを決定する基準 |
| revision_number | integer | リソースの改訂番号 |
| service_types | array | 関連付けられているサービスのタイプ |
| subnetpool_id | string | 関連付けられているサブネットプールのID |
| segment_id | string | 関連付けられているセグメントのID |
| updated_at | string | サブネットの更新日時 |
リクエスト例#
{ "subnet": { "network_id": "d32019d3-bc6e-4319-9c1d-6722fc136a22", "ip_version": 4, "cidr": "192.168.199.0/24" } }
レスポンス例#
{ "subnet": { "name": "", "enable_dhcp": true, "network_id": "d32019d3-bc6e-4319-9c1d-6722fc136a22", "segment_id": null, "project_id": "4fd44f30292945e481c7b8a0c8908869", "tenant_id": "4fd44f30292945e481c7b8a0c8908869", "dns_nameservers": [], "allocation_pools": [ { "start": "192.168.199.2", "end": "192.168.199.254" } ], "host_routes": [], "ip_version": 4, "gateway_ip": "192.168.199.1", "cidr": "192.168.199.0/24", "id": "3b80198d-4f7b-4f77-9ef5-774d54e17126", "created_at": "2016-10-10T14:35:47Z", "description": "", "ipv6_address_mode": null, "ipv6_ra_mode": null, "revision_number": 1, "service_types": [], "subnetpool_id": null, "updated_at": "2016-10-10T14:35:47Z" } }