建立一個專有網路(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的網段。您可以使用以下網段或其子集:
|
VpcName | String | 否 | VPC的名稱。 長度為 2-128個字元,必須以字母或中文開頭,可包含數字,點號(.),底線(_)和短橫線(-)。但不能以 |
Description | String | 否 | VPC的描述資訊。 長度為 2-256個字元,必須以字母或中文開頭,但不能以 |
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" }