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

使用说明

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

调试

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

请求参数

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

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

Ipv6GatewayId String ipv6bw-uf6hcyzu65v98v3du****

IPv6网关的ID。

Ipv6AddressId String ipv6bw-uf6hcyzu65v98v3du****

IPv6网关的实例ID。

InternetChargeType String PayByBandwidth

IPv6公网带宽的计费方式,取值:

  • PayByTraffic:按使用流量计费。
  • PayByBandwidth(默认值):按带宽计费。
Bandwidth Integer 2

IPv6网关的公网带宽,单位:Mbps,取值范围:1~5000

  • InternetChargeTypePayByBandwidth,IPv6网关的公网带宽为1~5000。
  • InternetChargeTypePayByTraffic,IPv6网关的公网带宽范围同时受到IPv6网关规格的制约。
    • Small(默认免费版),公网带宽范围为1~500。
    • Medium(企业版),公网带宽范围为1~1000。
    • Large(企业增强版),公网带宽范围为1~2000。
ClientToken String 123e4567-e89b-12d3-a456-426655440000

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

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

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

系统规定参数。取值:AllocateIpv6InternetBandwidth

返回数据

名称 类型 示例值 描述
Ipv6AddressId String ipv6bw-uf6hcyzu65v98v3du****

IPv6网关的实例ID。

RequestId String 6972A26E-99B1-4367-9890-FBDEBB0F5E7D

请求ID。

InternetBandwidthId String ipv6bw-uf6hcyzu65v98v3du****

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

示例

请求示例

https://vpc.aliyuncs.com/?AllocateIpv6InternetBandwidth
&Ipv6AddressId=ipv6-123456xxxxxxxx
&Ipv6GatewayId=ipv6gw-123456xxxxxxxx
&RegionId=cn-huhehaote
&<公共请求参数>

正常返回示例

XML格式

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

<?xml version="1.0" encoding="UTF-8" ?>
<AllocateIpv6InternetBandwidthResponse>
	<RequestId>6972A26E-99B1-4367-9890-FBDEBB0F5E7D</RequestId>
	<InternetBandwidthId>2</InternetBandwidthId>
	<Ipv6AddressId>ipv6-hp352ungkzcknxxxxxxxx</Ipv6AddressId>
</AllocateIpv6InternetBandwidthResponse>

JSON格式

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

{
  "RequestId" : "6972A26E-99B1-4367-9890-FBDEBB0F5E7D",
  "InternetBandwidthId" : 2,
  "Ipv6AddressId" : "ipv6-hp352ungkzcknxxxxxxxx"
}

错误码

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

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