调用AllocateIpv6InternetBandwidth为IPv6地址购买公网带宽-IPv6 网关-阿里云-IPv6 网关(IPv6 Gateway)-阿里云帮助中心

调用 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（默认值）：按带宽计费。 PayByOld95：表示按传统 95 计费。IPv6 公网带宽默认不支持按传统 95 计费，如需使用，请联系客户经理申请。	PayByBandwidth
Bandwidth	integer	是	IPv6 地址的公网带宽。单位：Mbps。当 InternetChargeType 为 PayByTraffic 时，公网带宽取值范围：1~1000。当 InternetChargeType 为 PayByBandwidth 时，公网带宽取值范围：1~2000。当 InternetChargeType 为 PayByOld95 时，公网带宽取值范围：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不存在，请检查您的输入是否正确

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

变更历史

更多信息，参考变更详情。