全部產品
Search

搜尋本產品

    Virtual Private Cloud：AllocateVpcIpv6Cidr - 預留指定的IPv6位址區段

    文件中心

    Virtual Private Cloud：AllocateVpcIpv6Cidr - 預留指定的IPv6位址區段

    更新時間：Apr 27, 2026

    預留指定的IPv6位址區段。

    介面說明

    為 VPC 分配指定 IPv6 位址區段的流程如下：

    1. 調用本介面預留指定的 IPv6 位址區段。

    2. 為存量 VPC 分配指定的 IPv6 位址區段時，請調用 AssociateVpcCidrBlock 介面，設定 RegionId、VpcId、IPv6CidrBlock 為指定的 IPv6 位址區段，IpVersion 為 ipv6；為建立 VPC 分配指定的 IPv6 位址區段時，請調用 CreateVpc 介面，設定 RegionId、Ipv6CidrBlock 為指定的 IPv6 位址區段、EnableIpv6 為 true。

    調試

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

    調試

    授權資訊

    當前API暫無授權資訊透出。

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    VPC 所在的地區 ID。

    您可以通過調用 DescribeRegions 介面擷取地區 ID。

    cn-hangzhou
    ClientToken

    string

    否

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

    說明

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

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

    string

    否

    VPC 的 IPv6 位址區段類型，取值：

    • BGP（預設值）：BGP（多線）。

    • BGP_International：BGP（多線）_國際。

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

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

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

    • ChinaMobile_L2：中國移動（單線）_L2。

    • ChinaUnicom_L2：中國聯通（單線）_L2。

    • ChinaTelecom_L2：中國電信（單線）_L2。

    說明

    • 如果是開通了對應白名單的使用者，該欄位可以設定為 ChinaTelecom（中國電信）、ChinaUnicom（中國聯通）、ChinaMobile（中國移動）、ChinaTelecom_L2（中國 L2 電信）、ChinaUnicom_L2（中國 L2 聯通）、ChinaMobile_L2（中國 L2 移動）和BGP_International（BGP 多線國際）。

    • 每種類型的 IPv6 位址區段只能預留一個，只有在分配給 VPC 後，才可以預留下一個。

    BGP
    RegionId

    string

    是

    VPC 所在的地區 ID。

    您可以通過調用 DescribeRegions 介面擷取地區 ID。

    cn-hangzhou
    AddressPoolType

    string

    否

    IPv6 位址集區的類型，取值如下：

    • aliyun（預設值）：系統分配 IPv6 位址區段。

    • custom：使用者自訂 IPv6 位址區段。

    custom
    Ipv6CidrBlock

    string

    否

    需要預留的 IPv6 位址區段。

    2408:XXXX:0:a600::/56

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回的資訊。

    Ipv6CidrBlock

    string

    預留的 IPv6 位址區段。

    2408:XXXX:0:a600::/56
    RequestId

    string

    請求 ID。

    D20C13EA-2584-53BC-8393-69DE6D98EFF1

    樣本

    正常返回樣本

    JSON格式

    {
  "Ipv6CidrBlock": "2408:XXXX:0:a600::/56",
  "RequestId": "D20C13EA-2584-53BC-8393-69DE6D98EFF1"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 OperationUnsupported.Ipv6Feature The IPv6 feature is not supported in the region. 當前地區不支援Ipv6特性。
    400 UnsupportedFeature.Ipv6Isp The Ipv6Isp feature is not supported. 指定的Ipv6Isp特性不支援。
    400 IllegalParam.AddressPoolType The specified addressPoolType is invalid. 指定的位址集區類型無效。
    400 ResourceNotEnough.Ipv6Cidr The specified resource ipv6 cidr is not enough. 指定的IPv6網段資源不足。
    400 IllegalParam.Ipv6Cidr The specified Ipv6CidrBlock is invalid. 指定的Ipv6CidrBlock非法。
    400 Unavailable.Ipv6Cidr The specified resource ipv6 cidr is not available. 指定的Ipv6網段不可用。
    400 IllegalParam.CidrBlock The param of cidrBlock is illegal. cidrBlock參數非法

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

    變更歷史

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