调用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（默认值）：按带宽计费。 PayByOld95：表示按传统95计费。IPv6公网带宽默认不支持按传统95计费，如需使用，请联系客户经理申请。
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	错误码	错误信息	描述
400	IllegalParam.Bandwidth	Invalid Bandwidth.	物理专线带宽值不合法。
400	MissingParam.Ipv6InstanceId	The param of Ipv6InstanceId is missing.	Ipv6InstanceId未指定
400	InvalidIpv6Instance.NotFound	The specified Ipv6AddressId or Ipv6InternetBandwidthId is not found.	指定的Ipv6AddressId或Ipv6InternetBandwidthId不存在
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.	指定的RegionId不存在。
500	OperationFailed.QueryAccountInfo	Query account info failed when create order.	下单时查询账号信息失败

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