建立一個專有網路(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"
    }