阅读170 返回首页    go 阿里云

修改共享带宽包-减少公网IP__NAT网关相关接口_API 参考_云服务器 ECS-阿里云

描述

去除IP时，指定要去除的IP列表；

  1. 不允许所有IP都去掉；如果请求中的IP列表囊括了现有所有IP，则报错；（报错意味着本次请求不合法，所有IP都没有发生删除行为）
  2. 如果出现了不在带宽包中的IP，则报错；（报错意味着本次请求不合法，所有IP都没有发生删除行为）
  3. 如果出现了某个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被端口转发规则引用。

示例

请求示例

  1. 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格式

  1. {
  2.   "RequestId": "7D275A59-1EB0-4775-8A20-2A47055EAC5C"
  3. }

最后更新：2016-12-18 11:59:32

  上一篇：go 修改共享带宽包-增加公网IP__NAT网关相关接口_API 参考_云服务器 ECS-阿里云
  下一篇：go 删除共享带宽包__NAT网关相关接口_API 参考_云服务器 ECS-阿里云