Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1451364414.8 KB

Deletes the specified <a>IPSet</a>.

post/#X-Amz-Target=AWSWAF_20190729.DeleteIPSet

Headers

X-Amz-Target'AWSWAF_20190729.DeleteIPSet' required

Request body

Namestring required

The name of the IP set. You cannot change the name of an <code>IPSet</code> after you create it.

Scope'CLOUDFRONT' | 'REGIONAL' required
<p>Specifies whether this is for an Amazon CloudFront distribution or for a regional application. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an Amazon Cognito user pool, or an App Runner service. </p> <p>To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows: </p> <ul> <li> <p>CLI - Specify the Region when you use the CloudFront scope: <code>--scope=CLOUDFRONT --region=us-east-1</code>. </p> </li> <li> <p>API and SDKs - For all calls, use the Region endpoint us-east-1. </p> </li> </ul>
Idstring required

A unique identifier for the set. This ID is returned in the responses to create and list commands. You provide it to operations like update and delete.

LockTokenstring required

A token used for optimistic locking. WAF returns a token to your <code>get</code> and <code>list</code> requests, to mark the state of the entity at the time of the request. To make changes to the entity associated with the token, you provide the token to operations like <code>update</code> and <code>delete</code>. WAF uses the token to ensure that no changes have been made to the entity since you last retrieved it. If a change has been made, the update fails with a <code>WAFOptimisticLockException</code>. If this happens, perform another <code>get</code>, and use the new token returned by that operation.

Response

Success

DeleteIPSetResponse required