调用AllocateIpv6InternetBandwidth接口为IPv6网关购买公网带宽。

使用说明

AllocateIpv6InternetBandwidth接口不支持并发购买同一个IPv6公网带宽。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String 是 cn-huhehaote

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

Ipv6GatewayId String 是 ipv6gw-uf6hcyzu65v98v3du****

IPv6网关的ID。
Ipv6AddressId String 是 ipv6-2zen5j4axcp5l5qyy****

IPv6地址的ID。
InternetChargeType String 否 PayByBandwidth

IPv6公网带宽的计费方式，取值：

  • PayByTraffic：按使用流量计费。
  • PayByBandwidth（默认值）：按带宽计费。
Bandwidth Integer 是 2

IPv6网关的公网带宽，单位：Mbps，取值范围：1~5000。
ClientToken String 否 123e4567-e89b-12d3-a456-426655440000

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

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

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

系统规定参数。取值：AllocateIpv6InternetBandwidth。

返回数据

名称 类型 示例值 描述
Ipv6AddressId String ipv6-2zen5j4axcp5l5qyy****

IPv6地址的ID。
RequestId String 6972A26E-99B1-4367-9890-FBDEBB0F5E7D

请求ID。
InternetBandwidthId String ipv6bw-uf6hcyzu65v98v3du****

开通公网带宽后，要查询的IPv6网关对应的公网带宽实例ID。

示例

请求示例

http(s)://[Endpoint]/?RegionId=cn-huhehaote
&Ipv6GatewayId=ipv6gw-uf6hcyzu65v98v3du****
&Ipv6AddressId=ipv6-2zen5j4axcp5l5qyy****
&InternetChargeType=PayByBandwidth
&Bandwidth=2
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Action=AllocateIpv6InternetBandwidth
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<AllocateIpv6InternetBandwidthResponse>
    <Ipv6AddressId>ipv6-2zen5j4axcp5l5qyy****</Ipv6AddressId>
    <RequestId>6972A26E-99B1-4367-9890-FBDEBB0F5E7D</RequestId>
    <InternetBandwidthId>ipv6bw-uf6hcyzu65v98v3du****</InternetBandwidthId>
</AllocateIpv6InternetBandwidthResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. 指定的RegionId不存在。

访问错误中心查看更多错误码。