全部產品
Search

搜尋本產品

    IPv6 Gateway：AllocateIpv6InternetBandwidth

    文件中心

    IPv6 Gateway：AllocateIpv6InternetBandwidth

    更新時間：Jun 18, 2026

    呼叫 AllocateIpv6InternetBandwidth 介面為 VPC 內的 IPv6 位址開通公網頻寬，使其具備公網通訊能力。開通後，該 IPv6 位址既可主動存取公網，也可被公網主動存取。

    介面說明

    • 支援為以下兩類 IPv6 位址開通公網頻寬：

      • 已分配給 ECS 執行個體彈性網卡的 IPv6 位址。

      • 未關聯任何資源執行個體的游離態 IPv6 位址。

    • 呼叫該介面前，請確保目標 IPv6 位址已存在，即 VPC 中的 ECS 執行個體已分配 IPv6 位址，或已透過 AllocateIpv6Address 建立了游離態 IPv6 位址。

    • 開通後，該 IPv6 位址既可主動存取公網，也可被公網主動存取。如果僅允許主動存取公網，可呼叫 CreateIpv6EgressOnlyRule 設定僅主動出規則。

    • AllocateIpv6InternetBandwidth 介面不支援並行購買同一個 IPv6 公網頻寬。

    • 使用場景：

      • ECS 執行個體 IPv6 公網存取：使 ECS 執行個體透過 IPv6 存取網際網路或對外提供服務。

      • 游離 IPv6 公網接入：配合 IPv6 閘道路由表，將公網流量導流至線下 IDC 等場景。

      • 僅出方向通訊：配合 CreateIpv6EgressOnlyRule，僅允許主動出方向存取，拒絕公網入方向連線。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vpc:AllocateIpv6InternetBandwidth

    create

    *Ipv6InternetBandwidth

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

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

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

    cn-huhehaote
    Ipv6GatewayId

    string

    否

    IPv6 閘道的 ID。

    ipv6gw-uf6hcyzu65v98v3du****
    Ipv6AddressId

    string

    是

    IPv6 位址的 ID。

    ipv6-2zen5j4axcp5l5qyy****
    InternetChargeType

    string

    否

    IPv6 公網頻寬的計費方式。取值：

    • PayByTraffic：按使用流量計費。

    • PayByBandwidth（預設值）：按頻寬計費。

    。

    PayByBandwidth
    Bandwidth

    integer

    是

    IPv6 位址的公網頻寬。單位：Mbps。

    • 當 InternetChargeType 為 PayByTraffic 時，公網頻寬取值範圍：1~1000。

    • 當 InternetChargeType 為 PayByBandwidth 時，公網頻寬取值範圍：1~2000。

    。

    200
    ClientToken

    string

    否

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

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

    說明

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

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

    boolean

    否

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

    • true：傳送檢查請求，不會關聯路由表。檢查項包括 AccessKey 是否有效、RAM 使用者的授權情況和是否填寫了必需參數。如果檢查不通過，則傳回對應錯誤。如果檢查通過，會傳回錯誤碼DryRunOperation。

    • false（預設值）：傳送正常請求，通過檢查後傳回 2xx HTTP 狀態碼並關聯路由表。

    false
    ClientToken

    string

    否

    客户端 Token，用于保证请求的幂等性。

    从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

    說明

    若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。

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

    string

    是

    IPv6 网关的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。

    cn-huhehaote

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Ipv6AddressId

    string

    IPv6 位址的 ID。

    ipv6-2zen5j4axcp5l5qyy****
    RequestId

    string

    請求 ID。

    6972A26E-99B1-4367-9890-FBDEBB0F5E7D
    InternetBandwidthId

    string

    開通公網頻寬後，要查詢的 IPv6 閘道對應的公網頻寬執行個體 ID。

    ipv6bw-uf6hcyzu65v98v3du****

    樣本

    正常返回樣本

    JSON格式

    {
  "Ipv6AddressId": "ipv6-2zen5j4axcp5l5qyy****",
  "RequestId": "6972A26E-99B1-4367-9890-FBDEBB0F5E7D",
  "InternetBandwidthId": "ipv6bw-uf6hcyzu65v98v3du****"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 IllegalParam.Bandwidth The param of %s is illegal. 当前指定的Bandwidth非法，请参考API文档参数说明修改后重试
    400 MissingParam.Ipv6InstanceId The param of Ipv6InstanceId is missing. Ipv6InstanceId未指定
    400 InvalidIpv6Instance.NotFound The specified Ipv6AddressId or Ipv6InternetBandwidthId is not found.
    400 IllegalParam.ChargeType The param of %s is illegal. 您输入的ChargeType非法，请参考API文档参数说明修改后重试
    400 IllegalParam.InternetChargeType The param of %s is illegal. 您指定的InternetChargeType非法，请参考API文档参数说明修改后重试
    400 OperationUnsupported.PrePaid %s is unsupported. Ipv6公网带宽不支持预付费，请参考API文档参数说明修改后重试
    400 OperationFailed.Ipv6GatewayDisMatchIpv6Address The operation is failed because of %s. 您所指定的Ipv6Address和Ipv6Gateway不在同一VPC内，请确认您的输入是否正确
    400 OperationFailed.InternetBandwidthAlreadyExisted The operation is failed because of %s. 您当前操作的Ipv6实例已开通公网带宽，请勿重复开通
    400 OperationFailed.Ipv6GatewayNotExist The operation is failed because of %s. 您当前操作的Ipv6地址所在的VPC不存在Ipv6Gateway实例，请创建Ipv6Gateway再进行该操作
    400 IncorrectStatus.Ipv6Instance The status of %s [%s] is incorrect. 您指定的Ipv6Instance实例处于非稳态，请稍后重试
    400 IllegalParam.Ipv6Address The param of %s is illegal. 您指定的ipv6地址非法，请检查您的输入是否正确
    400 UnsupportedFeature.InternetChargeTypeOnFreeIpv6Address The feature of %s is not supported. 当前Ipv6实例为游离态，不支持所指定的付费类型，请参考API文档参数说明修改后重试
    400 UnsupportedFeature.InternetChargeTypeOnStaticIsp The feature of %s is not supported. 当前指定Ipv6实例为单线ISP实例，不支持所指定的付费类型，请参考API文档参数说明修改后重试
    400 OperationUnsupported.ULA %s is unsupported. 当前操作不支持ULA地址
    400 OperationFailed.OpenCdtServiceFirst The operation is failed because of %s. 您当前指定的计费类型需开通CDT计费，请开通CDT后重试
    400 OperationFailed.UpgradeCdtServiceFirst The operation is failed because of cdt is not upgraded. 您当前指定购买的实例类型需升级CDT计费，请升级CDT后重试
    400 OperationUnsupported.PrivateGUA This operation does not support private GUA addresses. 当前操作不支持私网GUA地址。
    400 OperationDenied.UnSupportedBindTypeCloudInstance Internet bandwidth cannot be allocated to the IPv6 address bound to the cloud service instance. 绑定云服务类型实例的ipv6 ip 不能开通公网带宽。
    500 OperationFailed.QueryAccountInfo Query account info failed when create order. 下单时查询账号信息失败
    500 OperationFailed.SaleValidate Validate sale condition with subArticle failed.
    500 SystemBusy The system is busy. Please try again later. 当前系统繁忙，请稍后重试。
    404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
    404 ResourceNotFound.Ipv6Address The specified resource of %s is not found. 您指定的Ipv6Address不存在，请检查您的输入是否正确

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

    變更歷史

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