幫助中心
首頁 Virtual Private Cloud 開發參考 API參考 API目錄 Virtual Private Cloud CreateVpc

CreateVpc

更新時間：
Copy as MD
產品

建立一個專有網路 VPC。

介面說明

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

  • 一個 VPC 只能指定一個 IPv4 主網段，您可以新增 IPv4 附加網段來擴充網段。

  • VPC 建立後，您可以在原 IPv4 網段內放大或縮小網段。當您縮小 VPC 的 IPv4 網段時，如果有已經使用的 IP 位址在目標網段外，則會修改失敗。

  • 每個 VPC 支援雲端資源使用的私網網路位址數量為 300,000 個，且無法提升配額。

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

  • 每個 VPC 支援三個使用者側網段。如果多個使用者側網段之間存在包含關係，遮罩較短的網段實際生效。例如 10.0.0.0/16 和 10.0.0.0/24 中，10.0.0.0/16 實際生效。

  • CreateVpc 介面屬於非同步介面，即系統會傳回一個執行個體 ID，但該 VPC 尚未建立完成，系統後台的建立任務仍在進行。您可以呼叫 DescribeVpcAttribute 查詢 VPC 的建立狀態：

    • 當 VPC 處於 Creating 狀態時，表示 VPC 正在建立中。

    • 當 VPC 處於 Created 狀態時，表示 VPC 建立完成。

  • CreateVpc 介面支援在同一地域內並行建立非預設 VPC，受配額約束。

調試

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

調試

授權資訊

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

  • 操作：是指具體的許可權點。

  • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

  • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

    • 對於必選的資源類型，用前面加 * 表示。

    • 對於不支援資源級授權的操作，用全部資源表示。

  • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

  • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

vpc:CreateVpc

create

*VPC

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

 無 無

請求參數

名稱

類型

必填

描述

樣本值
RegionId

string

是

VPC 所在的地域 ID。

您可以透過呼叫 DescribeRegions 介面取得地域 ID。

cn-hangzhou
CidrBlock

string

否

VPC 的網段。

  • 建議您使用 RFC 1918 標準中指定的私有 IPv4 位址作為 VPC 的主 IPv4 網段，網段遮罩推薦使用 16~28 位元。例如：10.0.0.0/16、172.16.0.0/16、192.168.0.0/16。

  • 您也可以使用除 100.64.0.0/10、224.0.0.0/4、127.0.0.0/8 或 169.254.0.0/16 及其子網外的自訂位址段作為專有網路的主 IPv4 網段。

172.16.0.0/12
Ipv6CidrBlock

string

否

VPC 的 IPv6 網段。為 VPC 開啟 IPv6 時，系統將分配 IPv6 網段。如需指定 IPv6 網段，您需要先呼叫 AllocateVpcIpv6Cidr 介面預留指定的 IPv6 位址段，並將其傳入。

2408:XXXX:0:6a::/56
VpcName

string

否

VPC 的名稱。

長度為 1～128 個字元，不能以http://或https://開頭。

abc
EnableIpv6

boolean

否

是否開啟 IPv6。取值：

  • false（預設值）：不開啟。

  • true：開啟。

false
Description

string

否

VPC 的描述資訊。

長度為 1～256 個字元，不能以http://或https://開頭。

This is my first Vpc
ResourceGroupId

string

否

資源群組 ID。

關於資源群組的更多資訊，請參見什麼是資源群組。

rg-acfmxazb4ph6aiy****
Tag

array<object>

否

資源的標籤。

object

否

標籤。

Key

string

否

資源的標籤鍵。最多支援輸入 20 個標籤鍵。如需傳入該值，則不能輸入空字串。

一個標籤鍵最多支援 128 個字元，不能以aliyun和acs:開頭，不能包含http://或者https://。

FinanceDept
Value

string

否

資源的標籤值。最多支援輸入 20 個標籤值。如需傳入該值，可以輸入空字串。

最多支援 128 個字元，不能以aliyun和acs:開頭，不能包含http://或者https://。

FinanceJoshua
DryRun

boolean

否

是否只預檢此次請求。取值：

  • true：傳送檢查請求，不會建立 VPC。檢查項包括是否填寫了必需參數、請求格式、業務限制。如果檢查不通過，則傳回對應錯誤。如果檢查通過，則傳回錯誤碼DryRunOperation。

  • false（預設值）：傳送正常請求，通過檢查後傳回 HTTP 2xx 狀態碼並直接建立 VPC。

false
UserCidr

string

否

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

關於使用者網段的詳細資訊，請參見專有網路 FAQ的什麼是使用者網段。

192.168.0.0/12
ClientToken

string

否

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

從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

說明

若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。

123e4567-e89b-12d3-a456-426655440000
Ipv6Isp

string

否

VPC 的 IPv6 位址段類型。取值：

  • BGP（預設值）：阿里雲 BGP IPv6。

  • ChinaMobile：中國移動（單線）。

  • ChinaUnicom：中國聯通（單線）。

  • ChinaTelecom：中國電信（單線）。

說明

如果是開通了單線頻寬白名單的使用者，該欄位可以設定為 ChinaTelecom（中國電信）、ChinaUnicom（中國聯通）或 ChinaMobile（中國移動）。

BGP
Ipv4IpamPoolId

string

否

IPv4 類型的 IPAM 位址池執行個體 ID。

ipam-pool-sycmt3p2a9v63i****
Ipv4CidrMask

integer

否

透過輸入遮罩的方式從 IPAM 位址池分配 VPC。

說明

指定 IPAM 位址池建立 VPC 時，參數 CidrBlock 或 Ipv4CidrMask 至少輸入一個。

12
EnableDnsHostname

boolean

否

是否啟用 DNS 主機名稱功能。取值：

  • false（預設值）：不開啟。

  • true：開啟。

false
Ipv6IpamPoolId

string

否

IPv6 類型的 IPAM 位址池執行個體 ID。

ipam-pool-bp1aq51kkfh477z03****
Ipv6CidrMask

integer

否

透過輸入遮罩的方式從 IPAM 位址池為 VPC 新增 IPv6 網段。

56

返回參數

名稱

類型

描述

樣本值

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-bp145q7glnuzdv****
ResourceGroupId

string

資源群組 ID。

rg-acfmxazb4ph6aiy****

樣本

正常返回樣本

JSON格式

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

錯誤碼

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. 使用者名稱下的 VPC 數量達到配額上限。
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. 該 UserCidr 和 100.64.0.0/10 重疊。
400 InvalidResourceGroupId The specified ResourceGroupId does not exist. 資源群組ID不存在。
400 IllegalParam.Ipv6CidrBlock %s
400 OperationFailed.IPv6CidrNotReserved %s
400 MissingParam.EnableIpv6 %s
400 OperationUnsupported.Ipv6Feature %s
400 System.ServiceBusy System is busy, please try later.
400 IllegalParam.UserCidr UserCidr is not a valid or strict address. 參數 UserCidr 非法。
400 OperationUnsupported.ResourceGroupId ResourceGroup is not supported in this region. 操作不支援，在金融雲中不支援資源群組 ID。
400 IllegalParam.EnableIpv6 %s
400 InvalidIpv6CidrBlock.Malformed Specified Ipv6CidrBlock is not valid.
400 UnsupportedFeature.Ipv6Isp The Ipv6Isp feature is not supported. 指定的Ipv6Isp特性不支援。
400 ResourceNotEnough.Ipv6Cidr The specified resource of Ipv6Cidr is not enough. 指定的 IPv6 網段資源不足。
400 UnsupportedFeature.IPAM VPCs cannot be created by using IPAM. 該地域不支援 IPAM 功能。
400 IllegalParam.Ipv4CidrMask The specified Ipv4CidrMask is illegal. 指定的Ipv4CidrMask不合法。
400 IllegalParam.IpamPool The specified IPAM pool cannot be empty. IPAM Pool不可以為空。
400 OperationDenied.RequestRegionInvalid The operation is not allowed because the request is not invoked in the region of the IPAM pool. 操作被拒絕，因為未在位址池所在地域呼叫請求。
400 OperationDenied.IpamPoolNotInRegion The operation is not allowed because the IPAM pool not in specific region does not support creating VPC or associating CIDR for VPC. 操作被拒絕，因為無法從不具備地域屬性的位址池中建立 VPC 或為 VPC 新增附加網段。
400 MissingParam.CidrOrCidrMask The CIDR or CIDR Mask must be input. 從 IPAM 位址池建立資源時，請輸入 Cidr 或 CidrMask。
400 OperationDenied.CidrInExcludeCidrs The operation is not allowed because the input CIDR is within the illegal CIDRs. 操作被拒絕，原因是輸入的 CIDR 在不合法的 CIDR 範圍內。
400 OperationDenied.AvailableCidrInsufficient The operation is not allowed because available CIDR is insufficient. VPC 沒有可用的 CIDR 空間可供分配。
400 UnsupportedFeature.Ipam IPAM is not supported in this region.
400 OperationDenied.CidrUnavailableInPool The operation is not allowed because the CIDR is unavailable in the IPAM pool. 操作被拒絕，原因是 CIDR 在 IPAM 位址池中不可用。
400 IllegalParam.CidrBlockMask The param of CidrBlock Mask [%s] is illegal. CidrBlock 遮罩非法。
400 UnsupportedFeature.VpcDnsHostname The feature of vpc dns hostname is unsupported. VPC私網網域名稱功能在當前地域不生效。
400 OperationDenied.MaskOfCidrIsNotAllowed The input mask or mask of the input CIDR is not allowed. 輸入的遮罩或 CIDR 的遮罩不在允許的範圍內。
400 IllegalParam.Ipv6Isp The specified Ipv6Isp is illegal. 指定的Ipv6Isp參數不合法。
400 IllegalParam.CidrMask The input CIDR mask is illegal. 指定的網段遮罩不合法。
400 InvalidRegionId.NotFound Specified value of "regionId" is not supported.
400 UnsupportedFeature.DhcpOptionsSet The feature of dhcp options set is unsupported. DHCP 選項集相關功能在目前地域不生效。
400 OperationDenied.CidrMaskTooLarge The operation is denied because the CIDR mask %s is larger than the allocationMaxNetmask %s of the pool. 參數 Cidr 的遮罩或參數 CidrMask 超過了位址池合規規則中的最大網路遮罩長度。
400 OperationDenied.CidrMaskTooSmall The operation is denied because the CIDR mask %s is less than the allocationMinNetmask %s of the pool. 參數 Cidr 的遮罩或參數 CidrMask 小於位址池合規規則中的最小網路遮罩長度。
400 Mismatch.ParamIpv6IspAndIpamPoolIpv6Isp The specified IPv6 ISP %s does not match the IPAM pool's IPv6 ISP %s. 指定的 IPv6 營運商 %s 與 IPAM 位址池的 IPv6 營運商 %s 不符。
500 InternalError The request processing has failed due to some unknown error.
403 Forbidden User not authorized to operate on the specified resource. EIP 不屬於當前呼叫者，請您檢查該 EIP 是否可被您呼叫。
404 ResourceNotFound.IpamPool The dependent IPAM pool is not found. 依賴資源IPAM Pool不存在。

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

變更歷史

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

上一篇：Virtual Private Cloud下一篇：CreateDefaultVpc