Deletes an acceleration region.

Description

  • DeleteIpSet is an asynchronous operation. After you send a request, the system returns a request ID, but the operation is still being performed in the system background. You can call the DescribeIpSet operation to query the state of an acceleration region.
    • If the acceleration region is in the deleting state, the acceleration region is being deleted. In this case, you can perform only query operations.
    • If the acceleration region cannot be queried, the acceleration region is deleted.
  • The DeleteIpSet operation cannot be repeatedly called for the same Global Accelerator (GA) instance within a specific period of time.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DeleteIpSet

The operation that you want to perform. Set the value to DeleteIpSet.

RegionId String No cn-hangzhou

The ID of the region where the GA instance is deployed. Set the value to cn-hangzhou.

ClientToken String No DD61839A-5CC5-404B-8C6E-56066F0C432D

The client token that is used to ensure the idempotence of the request.

You can use the client to generate the value, but you must make sure that it is unique among different requests. The client token can contain only ASCII characters.

Note If you do not set this parameter, ClientToken is set to the value of RequestId. The value of RequestId may be different for each API request.
AcceleratorId String No ga-bp1yeeq8yfoyszmqy****

The ID of the GA instance.

IpSetId String Yes ips-bp11r5jb8ogp122xl****

The ID of the acceleration region that you want to delete.

Response parameters

Parameter Type Example Description
RequestId String DD61839A-5CC5-404B-8C6E-56066F0C432D

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DeleteIpSet
&RegionId=cn-hangzhou
&ClientToken=DD61839A-5CC5-404B-8C6E-56066F0C432D
&AcceleratorId=ga-bp1yeeq8yfoyszmqy****
&IpSetId=ips-bp11r5jb8ogp122xl****
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteIpSetResponse>
    <RequestId>DD61839A-5CC5-404B-8C6E-56066F0C432D</RequestId>
</DeleteIpSetResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "DD61839A-5CC5-404B-8C6E-56066F0C432D"
}

Error codes

HTTP status code Error code Error message Description
400 NotExist.IpSet The IpSet does not exist. The error message returned because the specified acceleration region does not exist.
400 StateError.IpSet The state of IpSet is invalid. The error message returned because the operation is not supported while the acceleration region is in the current state.
400 NotExist.Accelerator The accelerated instance does not exist. The error message returned because the specified GA instance does not exist.

For a list of error codes, visit the API Error Center.