调用UpdateIpSet接口修改加速区域中指定的加速地域。
使用说明
- UpdateIpSet接口属于异步接口,即系统会先返回一个请求ID,但加速区域中指定的加速地域并未修改完成,系统后台的修改任务仍在进行。您可以调用DescribeIpSet查询加速地域的状态:
- 当加速地域处于updating状态时,表示加速地域正在修改中,在该状态下,您只能执行查询操作,不能执行其他操作。
- 当加速地域处于active状态时,表示加速地域修改完成。
- UpdateIpSet接口不支持在同一个全球加速实例内并发修改加速地域。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateIpSet | 系统规定参数。取值:UpdateIpSet。 |
RegionId | String | 是 | cn-hangzhou | 全球加速实例所在的地域,仅取值cn-hangzhou。 |
ClientToken | String | 否 | 7D2F7E4E-B958-439C-9821-56D6213A31EC | 客户端Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。
说明 若您未指定,则系统自动使用API请求的
RequestId作为
ClientToken标识。每次API请求的
RequestId可能不一样。
|
IpSetId | String | 是 | ips-bp11r5jb8ogp122xl**** | 要修改的加速地域ID。 |
Bandwidth | Integer | 是 | 3 | 要修改的加速地域带宽。单位:Mbps。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 7D2F7E4E-B958-439C-9821-56D6213A31EC | 请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=UpdateIpSet
&RegionId=cn-hangzhou
&ClientToken=7D2F7E4E-B958-439C-9821-56D6213A31EC
&IpSetId=ips-bp11r5jb8ogp122xl****
&Bandwidth=3
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateIpSetResponse>
<RequestId>7D2F7E4E-B958-439C-9821-56D6213A31EC</RequestId>
</UpdateIpSetResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "7D2F7E4E-B958-439C-9821-56D6213A31EC"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Resource.QuotaFull | The resource quota is exceeded. | 该资源数量已达配额上限 |
400 | NotExist.IpSet | The IpSet does not exist. | IpSet不存在。 |
400 | StateError.IpSet | The state of IpSet is invalid. | IpSet状态非法。 |
400 | NotExist.Accelerator | The accelerated instance does not exist. | 加速实例不存在。 |
400 | StateError.Accelerator | The state of the accelerated instance is invalid. | 加速实例状态非法。 |
400 | NotExist.BasicBandwidthPackage | You must specify the basic bandwidth package. | 缺少基础带宽包 |
400 | GreaterThanGa.IpSetBandwidth | The total bandwidth for IpSet exceeds the total bandwidth of the GA instance. | IpSet配置的总带宽超过GA实例的总带宽 |
403 | Forbbiden.SubUser | You are not authorized to operate on the specified resource because your account was created by another user. | 该账号为其他账号的子账号,没有操作特定资源的权限。 |
403 | Forbidden | The user is not authorized to operate on the specified resource. | 该账号没有操作特定资源的权限。 |
500 | UnknownError | An error occurred while processing your request. Please try again. If the error persists, please submit a ticket. | 处理请求时出现错误,请稍后重试。 |
访问错误中心查看更多错误码。