调用ModifyCommonBandwidthPackageIpBandwidth接口为已经加入到共享带宽的EIP设置最大可用带宽值

使用说明

通过调用ModifyCommonBandwidthPackageIpBandwidth接口，您可以灵活分配加入到共享带宽中的每个EIP的最大可用带宽值，避免共享带宽的带宽值被某个EIP一直占用。

例如，2个EIP加入一个800 Mbps的共享带宽，可以为第一个EIP设置最大可用带宽值为500 Mbps，另外一个EIP设置最大可用带宽值为400 Mbps。设置完成后，第一个EIP可用的带宽值将不大于500 Mbps，第二个EIP可用的带宽值将不大于400 Mbps。

调用该接口前，请了解以下注意事项：

该接口仅针对EIP绑定ECS实例的场景生效，EIP绑定CLB实例、NAT网关、辅助弹性网卡、高可用虚拟IP场景配置该功能后无效。
该接口处于公测期，且仅可以通过该接口实现为已经加入到共享带宽的EIP设置最大可用带宽值，控制台暂不支持该功能。
该接口不支持对同一个EIP并发设置最大可用带宽值。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	ModifyCommonBandwidthPackageIpBandwidth	系统规定参数。取值：ModifyCommonBandwidthPackageIpBandwidth。
RegionId	String	是	cn-hangzhou	共享带宽所属的地域ID。您可以通过调用DescribeRegions接口获取地域ID。
BandwidthPackageId	String	是	cbwp-2zep6hw5d6y8exscd****	共享带宽的实例ID。
EipId	String	是	eip-2zewysoansu0svfbg****	已经加入到共享带宽的EIP的实例ID。
Bandwidth	String	是	500	在共享带宽内最大可分配的带宽值。单位：Mbps。

返回数据


名称	类型	示例值	描述
RequestId	String	63D187BF-A30A-4DD6-B68D-FF182C96D8A2	请求ID。

示例

请求示例

http(s)://vpc.aliyuncs.com/?Action=ModifyCommonBandwidthPackageIpBandwidth
&Bandwidth=500
&BandwidthPackageId=cbwp-2zep6hw5d6y8exscd****
&EipId=eip-2zewysoansu0svfbg****
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

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

<ModifyCommonBandwidthPackageIpBandwidth>
	<RequestId>63D187BF-A30A-4DD6-B68D-FF182C96D8A2</RequestId>
</ModifyCommonBandwidthPackageIpBandwidth>

JSON格式

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

{
  "RequestId" : "63D187BF-A30A-4DD6-B68D-FF182C96D8A2"
}

错误码


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

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