修改共享带宽包-减少公网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"}