新建專有網絡

　　描述

　　在指定的地域創建 1 個 VPC

　　VPC 只能指定 1 個 CIDRBlock，CIDRBlock 的范圍包括 10.0.0.0 / 8、172.16.0.0 / 12 和 192.168.0.0 / 16 及它們的子網，CIDRBlock 的掩碼為 8 - 24 位，默認為 172.16.0.0 / 12

　　VPC 創建后無法修改 CIDRBlock

　　每個 VPC 包含的云產品實例不能分布在不同 Region，可以分布在同一 Region 的不同可用區內

　　每個 VPC 包含的云產品實例數量不超過 5000 個

　　創建 VPC 時，會自動創建 1 個 VRouter 和 1 個 RouteTable。每個 VPC 只允許有 1 個 VRouter 和 1 個 RouteTable

　　每個VPC，支持3個用戶側網絡的網段 UserCidr ;如果多個用戶側網段之間存在互相包含(比如10.0.0.0/8和10.1.0.0/16，以10.0.0.0/8實際生效)

　　請求參數

名稱 類型 是否必須 描述
Action   String   是   系統規定參數，取值：CreateVpc  
RegionId   String   是   新建的 VPC 所在的地域  
CidrBlock   String   否   可選值 10.0.0.0/8、172.16.0.0/12和192.168.0.0/16及它們包含的子網。默認是172.16.0.0/12  
UserCidr   String   否   用戶自定義私網網段（多個 UserCidr 使用用半角逗號字符隔開，最多3個）  
VpcName   String   否   VPC 名稱，不填則為空，默認值為空，[2, 128] 英文或中文字符，必須以大小字母或中文開頭，可包含數字，”_”或”-”，磁盤描述會展示在控制臺。不能以 和 https:// 開頭  
Description   String   否   描述，不填則為空，默認值為空，[2, 256] 英文或中文字符，不能以 和 https:// 開頭  
ClientToken   String   否   用于保證請求的冪等性。由客戶端生成該參數值，要保證在不同請求間唯一，最大不值過 64 個 ASCII 字符，具體參見附錄  

　　返回參數

名稱 類型 描述
VpcId   String   系統分配的專有網絡 ID  
VRouterId   String   路由器 Id  
RouteTableId   String   路由表 Id  

　　錯誤碼

錯誤代碼 描述 Http 狀態碼 語義
InvalidRegionId.NotFound   Specified value of “RegionId” is not supported.   404   指定的 Region 不存在  
InvalidParameter   Specified CIDR block is not valid .   400   指定的網段不正確  
ResourceNotAvailable   Resource you requested is not available in this region or zone.   400   指定的 Region 或 Zone 不支持 VPC  
InvalidVpcName.Malformed   Specified VPC name is not valid.   400   VPCName 格式不正確  
InvalidVpcDiscription.Malformed   Specified VPC description is not valid.   400   指定的 VPC 描述信息不正確  
Forbbiden   User not authorized to operate on the specified resource.   403   用戶沒有指定資源的操作權限  
QuotaExceeded.Vpc   VPC quota exceeded.   400   用戶名下的 VPC 數量達到配額上限  
InvalidParameter   Specified UserCidr invalid format.   400   指定的 UserCidr 格式不合法  
InvalidParameter   Specified UserCidr Subnet mask is not valid.   400   指定的 UserCidr 子網掩碼不合法  
InvalidUserCidr.Quota   Specified UserCidr number is greater than 3.   400   指定的 UserCidr 個數大于3  
InvalidUserCidr.Malformed   Specified UserCidr overlapping in of 100.64.0.0/10.   400   指定的 UserCidr 與 100.64.0.0/10 網段重疊  

　　示例

　　請求示例

　　https://ecs.aliyuncs.com/?Action=CreateVpc

　　&RegionID=cn-beijing

　　&<公共請求參數>

　　返回示例