VPC を作成します。

本 API を呼び出す前に、次の点をご確認ください。
  • CIDR ブロック形式で VPC の IP アドレスの範囲を指定する必要があります。 標準のプライベート IP アドレス範囲またはそのサブネットを VPC の CIDR ブロックとして使用できます。 CIDR ブロックマスクのサイズは、8 ~ 24 bitです。 デフォルトの CIDR ブロックは 172.16.0.0/12 です。

  • VPC の作成後は CIDR ブロックの修正をすることはできません。

  • 各 VPC のクラウド製品インスタンスの数は15,000 以下である必要があります。

  • VPC の作成後に VRouter およびルートテーブルが自動的に作成されます。

  • VPC には最大 3 つのカスタマー側 CIDR ブロックを追加することができます。 1 つのカスタマー側 CIDR ブロックが別の CIDR ブロックのサブセットである場合、より短いマスクを持つブロックが有効になります。 たとえば、CIDR ブロックが 10.0.0.0/8 と10.1.0.0/16 の場合、カスタマー側の CIDR ブロック 10.0.0.0/8 が有効な CIDR ブロックになります。

デバッグ

OpenAPI Explorer を使用すると、API のデバッグ、SDK コード例の自動生成、API の迅速な検索を簡単にすることができます。

リクエストパラメーター

パラメーター データ型 必須 値の例 説明
Action String Yes CreateVpc

アクションの名前。 値 :

CreateVpc

RegionId String Yes cn-hangzhou

作成する VPC のリージョン ID 。

リージョン ID を照会するには、 DescribeRegions を呼び出します。

CidrBlock String No 172.16.0.0/12

CIDR ブロック形式の VPC の IP アドレス範囲。 次の IP アドレス範囲またはそのサブネットが使用可能です。

  • 10.0.0.0/8
  • 172.16.0.0/12 (デフォルト)
  • 192.168.0.0/16
ClientToken String No sha223ndd2333

リクエストの冪等性を保証するために使用されるクライアントトークン。

このパラメーター値は、クライアントによって生成される一意の値である必要があります。 長さは 1〜64 の ASCII 文字でなければなりません。

Description String No This is my first Vpc.

VPC の説明。

説明は 2 - 256 文字です。 名前は英字で始まる必要があります。先頭文字列を http://またはhttps://にすることはできません。

EnableIpv6 Boolean No 0

IPv6 CIDR ブロックを有効化するかを示します。 既定値:false

有効値: false | true

Ipv6CidrBlock String No 223.223.213.122

VPC の IPv6 CIDK ブロック。

ResourceGroupId String No 123

リソースグループの ID 。

UserCidr String No 189.16.0.0/12

カスタマー側の CIDR ブロック。 カンマで複数の CIDR ブロックを区切ります。 最大 3 つの CIDR ブロックを追加できます。

VpcName String No Vpc-1

VPCの名前。

名前の長さは 2 ~ 128 文字である必要があります。 大文字、小文字、数字を含めることができます。 ピリオド (.)、アンダースコア (_)、ハイフン (-) も使用可能です。 名前は英字で始まる必要があります。 先頭文字列を http://または https:// にすることはできません。

レスポンスパラメーター

パラメーター データ型 値の例 説明
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0 リクエストの ID 。
VpcId String vpc-bp15zckdt37pq72zvw30k VPC の ID。
VRouterId String vrt-bp1lhl0taikrteen80oxx VRouter の ID 。
RouteTableId String vtb-bp145q7glnuzdvzu21pom ルートテーブルの ID。
ResourceGroupId String rg-acfmxazb4ph6aiy

リソースグループの ID 。

リクエストの例

https://vpc.aliyuncs.com/?Action=CreateVpc
&RegionId=cn-hangzhou
&CidrBlock = 10.10.0.0/24
&CommonParameters
Response example
  • XML 形式

    <CreateVpcResponse>
      <ResourceGroupId>rg-acfmxazb4ph6aiy</ResourceGroupId>
      <RequestId> 8B2F5262-6B57-43F2-97C4-971425462DFE </RequestId>
      <RouteTableId> vtb-bp1krxxzp0c29fmontbal </RouteTableId>
      <VRouterId> vrt-bp1jcg5cmxjbl9xgc58bw </VRouterId>
      <VpcId> vpc-bp1qpo0kug3a20qqe9h7v </VpcId>
    </CreateVpcResponse>
    
  • JSON 形式

    {
    	 "RequestId":"8B2F5262-6B57-43F2-97C4-971425462DFE",
    	"ResourceGroupId":"rg-acfmxazb4ph6aiy",
    	"RouteTableId":"vtb-bp1krxxzp0c29fmontbal",
    	 "VpcId":"vpc-bp1qpo0kug3a20qqe9h7v",
    	"VRouterId":"vrt-bp1jcg5cmxjbl9xgc58bw"
    }

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
404 InvalidRegionId.NotFound regionId に指定された値はサポートされていません。 指定された RegionId は存在しません。
400 InvalidParameter 指定された CIDR ブロックは無効です。 CIDR ブロックが無効です。
400 ResourceNotAvailable 該当のリージョンまたはゾーンでは、リクエストされたリソースは利用できません。 該当のリージョンまたはゾーンに VSwitch を作成することはできません。
400 InvalidVpcName.Malformed 指定された VPC 名は無効です。 指定された VPC 名の形式が無効です。
400 QuotaExceeded.Vpc VPC クォータを超えました。 アカウントの VPC の最大数に達しました。
403 Forbbiden 指定されたリソースで操作を行う権限のないユーザー。 このリソースで操作を行う権限がありません。
400 ResourceNotAvailable.Vpc このリージョンまたはゾーンでは、リクエストされたリソースは利用できません。 このリージョンまたはゾーンでは、リクエストされたリソースは利用できません。
400 InvalidVpcName.Malformed 指定された VPC 名は無効です。 指定された VPC 名の形式が無効です。
400 InvalidParameter 指定された UserCidr は無効な形式です。 指定されたCIDRブロックは無効です。
400 InvalidParameter 指定された UserCidr サブネットマスクは無効です。 UserCidr に指定されたサブネットマスクが無効です。
400 InvalidUserCidr.Quota 指定された UserCidr 番号が 3 を超えています。 UserCird の数がクォータに達しました。
400 InvalidUserCidr.Malformed 指定された UserCidr は 100.64.0.0/10 と重複しています。 指定された UserCird が 100.64.0.0/10 と重複しています。
500 InternalError 不明なエラーが発生したため、リクエスト処理に失敗しました。 要求の処理中にエラーが発生しました。

一般的なエラーをご参照ください。