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

API描述

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

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

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

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ModifyCommonBandwidthPackageIpBandwidth

要执行的操作，取值：ModifyCommonBandwidthPackageIpBandwidth。

Bandwidth String 是 500

在共享带宽内最大可分配的带宽值，单位为Mbps。
BandwidthPackageId String 是 cbwp-2zep6hw5d6y8exscd****

共享带宽的实例ID。
EipId String 是 eip-2zewysoansu0svfbg****

已经加入到共享带宽的EIP的实例ID。
RegionId String 是 cn-hangzhou

共享带宽所属的地域ID。您可以通过调用DescribeRegions接口获取地域ID。

返回数据

名称 类型 示例值 描述
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 格式 

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

JSON 格式 

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

错误码

HttpCode 错误码 错误信息 描述
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. 指定的 RegionId 不存在，请您检查此产品在该地域是否可用。

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