You need to enable JavaScript to run this app.
导航
AllocateIpv6AddressBandwidth
最近更新时间:2024.11.15 09:48:18首次发布时间:2022.10.10 09:46:29

调用 AllocateIpv6AddressBandwidth 接口,为指定IPv6地址开通IPv6公网带宽。

调用说明

  • 私网双栈应用型负载均衡实例不支持开通IPv6公网带宽,公网双栈应用型负载均衡实例在创建时,系统自动为其开通IPv6公网带宽。
  • 目标IPv6地址所在VPC已关联IPv6网关。
    您可调用 DescribeIpv6Gateways 接口,查看是否关联,若未关联,可调用 CreateIpv6Gateway接口,创建IPv6网关并关联VPC。

请求参数

参数名称
类型
是否必选
示例值
描述
ActionStringAllocateIpv6AddressBandwidth要执行的操作,取值为AllocateIpv6AddressBandwidth。
VersionString2020-04-01API版本信息,当前版本为2020-04-01。
Ipv6AddressString2408::153:3921:XX:XX:7b12:1c5f待开通IPv6公网带宽的IPv6地址。

BillingType

Integer

3

IPv6公网带宽的计费方式。

  • 2:按量计费-按带宽上限计费。

  • 3:按量计费-按实际流量计费。

Bandwidth

Integer

5

IPv6公网带宽的带宽上限,单位为Mbps。

  • BillingType 传入2:取值范围1 ~ 500。
  • BillingType 传入3:取值范围1 ~ 200。
  • 不填默认为1Mbps。

BandwidthPackageId

String

bwp-2zeo05qre24nhrqpy****

IPv6共享带宽包的ID。
您可以调用 CreateBandwidthPackage 接口,查询共享带宽包的ID。

ClientToken

String

0c593ea1-3bea-11e9-b96b-88e9fe63****

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

  • 该参数值由客户端自动生成,确保不同请求的取值唯一,避免当调用API超时或服务器内部错误时,客户端多次重试导致重复性操作。
  • 取值仅支持ASCII字符,最大不超过64个字符。
  • 未指定该参数值时,不进行幂等校验。

返回数据

参数名称
类型
示例值
描述
RequestIdString2021062415303301022514515207C4****请求ID。
AllocationIdStringeip-2zaiwb7ujxscd****IPv6公网带宽的ID。

请求示例

GET /?Action=AllocateIpv6AddressBandwidth&Version=2020-04-01&Ipv6Address=2408::153:3921:XX:XX:7b12:1c5f&BillingType=3&Bandwidth=5 HTTP/1.1
Host: open.volcengineapi.com
Region: cn-guangzhou
Service: vpc

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021062415303301022514515207C4****",
        "Action": "AllocateIpv6AddressBandwidth",
        "Version": "2020-04-01",
        "Service": "vpc",
        "Region": "cn-guangzhou"
    }, 
    "Result": {
        "RequestId": "2021062415303301022514515207C4****",
        "AllocationId": "eip-2zaiwb7ujxscd****"
    }
}

错误码

公共错误码,请参见 公共错误码 。

HttpCode
错误码
错误信息
描述
400IdempotentParameterMismatchArguments on this idempotent request are inconsistent with arguments used in previous request(s).此幂等请求的参数与前一个请求中使用的参数不一致。
400InvaildIpv6.NotSupportThe specified IPv6 address does not support this operation.指定的IPv6地址不支持此操作。
400InvalidBandwidth.MalformedThe specified bandwidth is malformed.Ensure that bandwidth is not smaller than 1.指定的带宽不合法。如果指定带宽,请确保不小于1。
400InvalidBandwidthPackage.InvalidStatusThe specified bandwidth package is not in the correct status for the request. The specified bandwidth package is in freeze.指定的共享带宽包所处的状态无法响应该请求。当前共享带宽包被冻结。
400InvalidBillingType.MalformedThe specified billing type is malformed.指定的计费类型不合法。
400InvalidIpv6.BandwidthAlreadyExistedOperation failed because IPv6 address bandwidth already exists.指定的IPv6地址已经开通了公网带宽。
400InvalidIpv6.MalformedThe specified IPv6 address is malformed.指定的IPv6地址不合法。
400InvalidIpv6Gateway.InvalidStatusThe specified IPv6Gateway is not in the correct status for the request.指定的IPv6网关所处状态无法响应该请求。
400InvalidParameter.ClientTokenMalformedThe specified parameter ClientToken is malformed.指定的参数ClientToken格式不合法,长度不能超过64个ASCII字符。
400InvalidProtocol.MismatchThe protocol of the bandwidth package does not match with the EIP.共享带宽包与EIP的协议类型不匹配。
400LimitExceeded.Ipv6You've reached the limit on the bandwidth of IPv6 address that you can create.已达到IPv6地址带宽上限。
400OrderErrorFailed to create an order in one step.创建订单并支付失败。
400PreOrderErrorFailed to create pre order.创建配置单失败。
400QuotaExceeded.BandwidthPackageYou've reached the limit on the EIP number of that you can add to bandwidth package.已达到共享带宽包可加入公网IP的数量上限。
400QuotaExceeded.IPv6BandwidthYou've reached the limit on the number of IPv6 bandwidth that you can create.已达到可开通IPv6公网带宽数量上限。
400InvaildIpv6.GatewayNotExistThe VPC of the specified IPv6 address does not have an Ipv6gateway.指定的IPv6地址所在的VPC没有开通IPv6网关。
400InvalidAlb.InvalidStatusThe specified ALB is not in the correct status for the request. Current ALB has been frozen.指定的ALB所处状态无法响应该请求。当前ALB被冻结。
400InvalidClb.InvalidStatusThe specified CLB is not in the correct status for the request. Current CLB has been frozen.指定的CLB所处状态无法响应该请求。当前CLB被冻结。
400InvalidInstance.InvalidStatusThe specified ECS is not in the correct status for the request. Current ECS has been frozen.指定的ECS所处状态无法响应该请求。当前ECS被冻结。
400InvalidEni.InvalidStatusThe specified elastic network interface is not in the correct status for the request.指定的弹性网卡所处的状态无法响应该请求。
403ForbiddenYou are not authorized to perform operations on ESI related resources.无权限操作弹性预约实例关联资源。
403ForbiddenYou are not authorized to perform operations on the specified IPv6 address which is managed by ALB.无权限操作ALB的IPv6地址。
403ForbiddenYou are not authorized to perform operations on create IPv6 gateway.无权限创建IPv6网关。
403Forbidden.PurchaseLimitedThe account is not authorized to purchase the resource.此账户无权限购买资源。
404InvalidBandwidthPackage.NotFoundThe specified bandwidth package does not exist.指定的共享带宽包不存在。
404InvalidIpv6.AddressIpNotFoundThe specified IPv6 address can not be found未找到指定的IPv6地址。
404InvalidInstance.NotFoundThe specified instance does not exist.指定的实例不存在。
412IdempotentProcessingThe request uses the same client token as a previous one that is still in process.幂等请求处理中。