Create subnet

指定したネットワークにサブネットを作成します。

URI

/v2.0/subnets

HTTPメソッド

POST

リクエストパラメタ

キー 説明 型 必須/省略可
name サブネット名 xsd:string Optional
network_id アタッチされているネットワークのID csapi:uuid required
allocation_pools 割り当てプールの開始アドレスと終了アドレス xsd:dict Optional
dns_nameservers サブネット用DNSネームサーバの一覧

例: [“8.8.8.7”, “8.8.8.8”].

指定したIPアドレスは昇順にソートされた状態で表示されます。

最後に表示されているIPアドレスがプライマリDNSアドレスです。

 xsd:string Optional
host_routes サブネットに所属する仮想サーバのスタティックルーティング一覧。以下はその一例です。 

"host_routes":[
	{
		"destination":"0.0.0.0/0",
		"nexthop":"172.16.1.254"
	},
	{
		"destination":"192.168.0.0/24",
		"nexthop":"192.168.0.1"
	}
]
xsd:list Optional
gateway_ip ゲートウェイのIPアドレス xsd:string Optional
ip_version IPバージョン (4または6) xsd:string Required
cidr サブネットのCIDR xsd:bool 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 サービスまたは物理サーバ for SAP HANA サービスで利用するSubnetを作成する場合、以下の内容に留意願います。

  • nameのパラメタは先頭に、以下の文字列を付与して作成してください。
    Windows仮想サーバ for SAP サービスの場合：
    fcx_subnet-w:
    物理サーバ for SAP HANA サービスの場合：
    fcx_subnet-b:
  • cidrで指定可能なマスク値は16～29の範囲です。
  • allocation_poolsおよびgateway_ipに指定したIPアドレス以外が、Windows仮想サーバ for SAP サービスまたは物理サーバ for SAP HANA サービスで作成したサーバ(VM)に割り当てられるIPアドレスになります。

    allocation_poolsには、Windows仮想サーバ for SAP サービスまたは物理サーバ for SAP HANA サービスで使用するIPアドレスの範囲を除いて指定してください。

  • ip_versionには4を指定してください。
  • host_routes、enable_dhcp、およびdns_nameserversに指定した情報は、Windows仮想サーバ for SAP サービスまたは物理サーバ for SAP HANA サービスで作成したサーバ(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 サブネットに所属する仮想サーバのスタティックルーティング一覧。以下はその一例です。 

"host_routes":[
	{
		"destination":"0.0.0.0/0",
		"nexthop":"172.16.1.254"
	},
	{
		"destination":"192.168.0.0/24",
		"nexthop":"192.168.0.1"
	}
]
gateway_ip ゲートウェイのIPアドレス
ip_version IPバージョン (4)
cidr サブネットのCIDR
id サブネットID
enable_dhcp DHCPが有効な場合は"true"、無効な場合は"false"に設定します。
availability_zone アベイラビリティゾーン名