ModifyCommonBandwidthPackageIpBandwidth_专有网络_API文档-阿里云OpenAPI开发者门户

接口说明

通过调用 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 并发设置最大可用带宽值。

流控信息

请求速率为300/60(s)。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

vpc:ModifyCommonBandwidthPackageIpBandwidth	Update	BandwidthPackage acs:vpc:{#regionId}:{#accountId}:combandwidthpackage/{#BandwidthPackageId}	无	无

请求参数

字段名称	字段详情
RegionIdstring	共享带宽所属的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。示例值:cn-hangzhou参考取值来源: DescribeRegions
BandwidthPackageIdstring	共享带宽的实例 ID。示例值:cbwp-2zep6hw5d6y8exscd****参考取值来源: AddCommonBandwidthPackageIp CreateCommonBandwidthPackage DescribeCommonBandwidthPackages
EipIdstring	已经加入到共享带宽的 EIP 的实例 ID。示例值:eip-2zewysoansu0svfbg****
Bandwidthstring	在共享带宽内最大可分配的带宽值。单位：Mbps。示例值:500参考取值来源: AddCommonBandwidthPackageIp CreateCommonBandwidthPackage AllocateIpv6InternetBandwidth DescribeCommonBandwidthPackages

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:63D187BF-A30A-4DD6-B68D-FF182C96D8A2

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	%s	%s	诊断
400	OperationFailed.DistibuteLock	Distibute lock fail.	诊断
400	Forbidden.FinancialLocked	The ip business status is invalid.	诊断
400	InvalidEIPStatus.BizDisabled	The EIP has been locked.	诊断
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.	诊断
404	%s	%s	诊断

变更历史

	变更时间	变更内容概要	操作
	2022-11-29	变更错误码400