CreateDefaultVpc

建立一個預設的專有網路VPC。

介面說明

呼叫該介面建立預設 VPC 時，請注意：

預設 VPC 建立後無法修改網段，但可以新增附加 IPv4 網段。
每個預設 VPC 支援雲端資源使用的私有網路位址數量為 300,000 個，且無法提升配額。
建立預設 VPC 後，會自動建立一個路由器和一個路由表。
每個預設 VPC 支援三個使用者側網段。如果多個使用者側網段之間存在包含關係，遮罩較短的網段實際生效。例如 10.0.0.0/16 和 10.0.0.0/24 中，10.0.0.0/16 實際生效。
CreateDefaultVpc 介面屬於非同步介面，即系統會傳回一個實例 ID，但該預設 VPC 尚未建立完成，系統後台的建立任務仍在進行。您可以呼叫 DescribeVpcAttribute 查詢預設 VPC 的建立狀態：
- 當預設 VPC 處於 Pending 狀態時，表示預設 VPC 正在設定中。
- 當預設 VPC 處於 Available 狀態時，表示預設 VPC 可用。
CreateDefaultVpc 介面不支援在同一地域內並行建立預設 VPC。
一個地域當前只能有一個預設 VPC。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

vpc:CreateDefaultVpc

create

*VPC

acs:vpc:{#regionId}:{#accountId}:vpc/*

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	預設 VPC 所在的地域 ID。您可以透過呼叫 DescribeRegions 介面取得地域 ID。	cn-hangzhou
Ipv6CidrBlock	string	否	預設 VPC 的 IPv6 網段。說明當 EnableIpv6 取值為 true 時，需要輸入該參數。	2408:XXXX:346:b600::/56
EnableIpv6	boolean	否	是否開啟 IPv6 網段。取值： false（預設值）：不開啟。 true：開啟。	false
ResourceGroupId	string	否	資源群組 ID。	rg-acfmystnjq4****
ClientToken	string	否	用戶端 Token，用於保證請求的冪等性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。說明若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。	123e4567-e89b-12d3-a456-426655440000

返回參數

名稱	類型	描述	樣本值
	object	建立的預設 VPC 的 ID。
VpcId	string	建立的預設 VPC 的 ID。	vpc-bp15zckdt37pq72zv****
VRouterId	string	建立預設 VPC 後，系統自動建立的路由器的 ID。	vrt-bp1lhl0taikrteen8****
RequestId	string	請求 ID。	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
RouteTableId	string	建立預設 VPC 後，系統自動建立的路由表的 ID。	vtb-bp1q1uirugzb1x32m****

樣本

正常返回樣本

JSON格式

{
  "VpcId": "vpc-bp15zckdt37pq72zv****",
  "VRouterId": "vrt-bp1lhl0taikrteen8****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "RouteTableId": "vtb-bp1q1uirugzb1x32m****"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
400	TOKEN_PROCESSING	Action is processing.
400	InvokeError	instance quota rule invoke error.
400	InvalidParameter	Specified CIDR block is not valid
400	ResourceNotAvailable	Resource you requested is not available in this region or zone.
400	InvalidVpcName.Malformed	Specified VPC name is not valid.
400	InvalidVpcDiscription.Malformed	Specified VPC description is not valid.
400	QuotaExceeded.Vpc	VPC quota exceeded.
400	ResourceNotAvailable.Vpc	Resource you requested is not available in this region or zone.
400	InvalidUserCidr.Quota	Specified UserCidr number is greater than 3.
400	InvalidUserCidr.Malformed	Specified UserCidr overlapping in of 100.64.0.0/10.
400	InvalidResourceGroupId	The specified ResourceGroupId does not exist.
400	IllegalParam.Ipv6CidrBlock	%s
400	OperationFailed.IPv6CidrNotReserved	%s
400	MissingParam.EnableIpv6	%s
400	OperationUnsupported.Ipv6Feature	%s
400	IllegalParam.ZoneId	%s
400	OperationFailed.DefaultVpcExist	%s
400	InvalidRegionId.NotFound	Specified value of "regionId" is not supported.
500	InternalError	The request processing has failed due to some unknown error.
403	Forbbiden	User not authorized to operate on the specified resource.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。