建立一個專有網路（VPC）。

調用該介面建立VPC時，請注意：

  • VPC只能指定一個網段，網段的範圍包括10.0.0.0/8、172.16.0.0/12和192.168.0.0/16以及它們的子網，網段的掩碼為8-24位，預設為172.16.0.0/12。

  • VPC建立後無法修改網段。

  • 每個VPC包含的雲產品執行個體數量不超過15000個。

  • 建立VPC後，會自動建立一個虛擬路由器和一個路由表。

  • 每個VPC支援三個使用者側網段。如果多個使用者側網段之間存在互相包含，掩碼較短的網段實際生效。例如10.0.0.0/8和10.1.0.0/16中，10.0.0.0/8實際生效。

請求參數

名稱 類型 是否必須 描述
Action String 是

要執行的操作。 取值：

CreateVpc
RegionId String 是

VPC所在的地域。

您可以通過調用 DescribeRegions介面獲取地域ID。

CidrBlock String 否

VPC的網段。您可以使用以下網段或其子集：

  • 10.0.0.0/8
  • 172.16.0.0/12（預設值）
  • 192.168.0.0/16
VpcName String 否

VPC的名稱。

長度為 2-128個字元，必須以字母或中文開頭，可包含數字，點號（.），底線（_）和短橫線（-）。但不能以http:// 或https://開頭。

Description String 否

VPC的描述資訊。

長度為 2-256個字元，必須以字母或中文開頭，但不能以http:// 或https://開頭。

ClientToken String 否

用戶端token，用於保證請求的等冪性。

由用戶端生成該參數值，要保證在不同請求間唯一，最大不值過64個 ASCII 字元。
UserCidr String 否

使用者側網路的網段，如需定義多個網段請使用半形逗號隔開，最多支援3個網段。

返回參數

名稱 類型 描述
RequestId String 請求ID。
VpcId String VPC的ID。
VRouterId String 路由器的ID。
RouteTableId String 路由表的ID。

樣本

請求樣本

https://vpc.aliyuncs.com/?Action=CreateVpc
&RegionId=cn-hangzhou
&CidrBlock=10.10.0.0/24
&公共請求參數
返回樣本

  • XML格式

    <?xml version="1.0" encoding="UTF-8"?>
<CreateVpcResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
    <RouteTableId>vtb-bp145q7glnuzdvzu21pom</RouteTableId>
    <VRouterId>vrt-bp1lhl0taikrteen80oxx</VRouterId>
    <VpcId>vpc-bp15zckdt37pq72zvw3</VpcId>
</CreateVpcResponse>

  • JSON格式

    { 
    "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0", 
    "RouteTableId": "vtb-bp145q7glnuzdvzu21pom", 
    "VRouterId": "vrt-bp1lhl0taikrteen80oxx", 
    "VpcId": "vpc-bp15zckdt37pq72zvw30k"
}