修改共享带宽包-减少公网IP
描述
去除IP时,指定要去除的IP列表;
不允许所有IP都去掉;如果请求中的IP列表囊括了现有所有IP,则报错;(报错意味着本次请求不合法,所有IP都没有发生删除行为)
如果出现了不在带宽包中的IP,则报错;(报错意味着本次请求不合法,所有IP都没有发生删除行为)
如果出现了某个IP被SNAT、Portmap规则引用的情况,则报错;(报错意味着本次请求不合法,所有IP都没有发生删除行为)
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
String
是
系统规定参数,取值:RemoveBandwidthPackageIps
RegionId
String
是
共享带宽包所在的地域
BandwidthPackageId
String
是
要修改的BandwidthPackage的Id
RemovedIpAddresses.n
Array
否
要去除的IP地址的AllocationId(填写IP的AllocationId而不是IP地址)
n必须从1开始排列,最大为20;
若指定了某个不存在的IP,则本次删除行为失败,所有IP都没有被删除;
若指定了当前带宽包中的所有IP,则本次删除行为失败——不允许出现某个带宽包中没有IP的情况
ClientToken
String
否
用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。具体参见附录.
返回参数
全是公共返回参数,详见公共返回参数
错误码
错误代码 |
描述 |
Http 状态码 |
语义 |
InvalidRegionId.NotFound
Specified value of “RegionId” is not supported.
404
指定的 Region 不存在
InvalidBandwidthPackageId.NotFound
Specified value of BandwidthPackageId is not found in our record.
404
指定的BandwidthPackage不存在
InvalidRemovedIpAddresses.NotFound
Some of the specified value of RemovedIpAddress not found in specified BandwidthPackage
400
指定的某个IP地址并不存在于指定的共享带宽包上。
Forbidden.RemoveAllIps
It’s forbidden that remove all IPs in BandwidthPackage.
400
禁止去除一次性移除带宽包中的所有IP
Forbidden.SomeIpReferredByForwardEntry
It’s forbidden because there are some specified RemovedIpAddresses referred by ForwardEntry.
400
指定要删除的IP中,有IP被端口转发规则引用。
示例
请求示例
https://ecs.aliyuncs.com/?RemovedIpAddresses.2=nateip-11s2jempe&SignatureVersion=1.0&BandwidthPackageId=bwp-11odxu2k7&Format=json&TimeStamp=2016-05-23T04%3A01%3A34Z&RegionId=cn-shanghai&RemovedIpAddresses.1=nateip-1110a2l48&AccessKeyId=jZgi0oyrQ6ihgKp9&SignatureMethod=HMAC-SHA1&Version=2014-05-26&Signature=l4NbMQD5X1xkLrgBZm34Aj4uwiI%3D&action=RemoveBandwidthPackageIps&SignatureNonce=0a34f3f3-209b-11e6-b183-2cf0ee28adf2
返回示例
XML格式
暂略
JSON格式
{ "RequestId": "7D275A59-1EB0-4775-8A20-2A47055EAC5C"}
所属专题: