Create subnet
指定したネットワークにサブネットを作成します。
URI
/v2.0/subnets
HTTPメソッド
POST
リクエストパラメタ
| キー | 説明 | 型 | 必須/省略可 |
|---|---|---|---|
| name | サブネット名 | xsd:string | Optional |
| network_id | アタッチするネットワークのID | csapi:uuid | required |
| allocation_pools | 割り当てるIPアドレスプールの開始アドレスと終了アドレス
注意: enable_dhcpをtrueに設定した場合、allocation_poolsに[]（空配列）を指定しないでください。 allocation_poolsに[]（空配列）を指定すると、ポートの作成に失敗します。 |
xsd:dict | Optional |
| dns_nameservers | サブネット用DNSネームサーバの一覧
例: [“8.8.8.7”, “8.8.8.8”]. |
xsd:string | Optional |
| host_routes | サブネットに所属する仮想サーバのスタティックルーティング一覧。以下はその一例です。
|
xsd:list | Optional |
| gateway_ip | ゲートウェイのIPアドレス | xsd:string | Optional |
| ip_version | IPバージョン (4または6) | xsd:string | Required |
| cidr | サブネットのCIDR | xsd:string | required |
| enable_dhcp | DHCPが有効な場合は"true"、無効な場合は"false"に設定します。 | xsd:boolean | Optional |
| availability_zone | アベイラビリティゾーン名
指定しなかった場合、リソースはデフォルトのアベイラビリティゾーンに作成されます。 |
xsd:string | Optional |
注意:
- ISP shared address(100.64.0.0/10あるいは、そのサブネットを分割したサブネットアドレス)は指定しないでください。
- 1つのNetworkと関連づけられるsubnetは1つです。
注意:
Windows仮想サーバ for SAP サービスで利用するSubnetを作成する場合、以下の内容に留意願います。
- nameのパラメタは先頭に、以下の文字列を付与して作成してください。
- Windows仮想サーバ for SAP サービスの場合：
- fcx_subnet-w:
- cidrで指定可能なマスク値は16～29の範囲です。
- allocation_poolsおよびgateway_ipに指定したIPアドレス以外が、Windows仮想サーバ for SAP サービスで作成したサーバ(VM)に割り当てられるIPアドレスになります。
allocation_poolsには、Windows仮想サーバ for SAP サービスで使用するIPアドレスの範囲を除いて指定してください。
- ip_versionには4を指定してください。
- host_routes、enable_dhcp、およびdns_nameserversに指定した情報は、Windows仮想サーバ for SAP サービスで作成したサーバ(VM)に設定されません。
注意:
SSL-VPN接続で利用するSubnetを作成する場合、以下の内容に留意願います。
- cidrで指定可能なマスク値は16～29の範囲です。
- gateway_ipは、VPN Serviceで指定するルータのIPアドレスを指定してください。
リクエスト例
{
"subnet": {
"network_id": "d32019d3-bc6e-4319-9c1d-6722fc136a22",
"ip_version": 4,
"cidr": "192.168.199.0/24",
"availability_zone": "AZ1"
}
}
レスポンスステータス
| ステータスコード | 説明 |
|---|---|
| 201 | Normal response codes |
| badRequest (400) | Error response codes |
| unauthorized (401) | Error response codes |
| forbidden (403) | Error response codes |
| itemNotFound (404) | Error response codes |
| conflict (409) | Error response codes |
レスポンスボディ(正常系)
{
"subnet": {
"name": "",
"enable_dhcp": true,
"network_id": "d32019d3-bc6e-4319-9c1d-6722fc136a22",
"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",
"availability_zone": "AZ1"
}
レスポンスボディ(正常系)の説明
| 要素名 | 説明 |
|---|---|
| name | サブネット名 |
| network_id | アタッチされているネットワークのID |
| tenant_id | ネットワークを所有しているプロジェクトID |
| dns_nameservers | サブネット用DNSネームサーバの一覧
例: [“8.8.8.7”, “8.8.8.8”]. |
| allocation_pools | 割り当てプールの開始アドレスと終了アドレス |
| host_routes | サブネットに所属する仮想サーバのスタティックルーティング一覧。以下はその一例です。
|
| gateway_ip | ゲートウェイのIPアドレス |
| ip_version | IPバージョン (4) |
| cidr | サブネットのCIDR |
| id | サブネットID |
| enable_dhcp | DHCPが有効な場合は"true"、無効な場合は"false"に設定します。 |
| availability_zone | アベイラビリティゾーン名 |