AWS WAF icon

AWS WAF

Manage AWS WAF IP Sets - Add/Remove IP from blacklist

Actions4

Get IP Set

AI-generated

Summary

Retrieves the configuration details and lock token for a specific AWS WAF IP Set.

Inputs

  • scope (required) — Specifies whether the IP Set is regional (REGIONAL) or CloudFront (CLOUDFRONT).
  • ipSetName (required) — The name of the IP Set to retrieve details for.
  • ipSetId (required) — The unique identifier of the IP Set.

Output shape

A single item containing the IP Set definition (Addresses, Description, Id, Locked, Name, Scope, Tags) and the LockToken required for subsequent updates.

The LockToken is required to update the IP Set later; failing to use it in an update operation will cause a validation error.

Examples

Example 1: Retrieve a regional IP Set named 'blocked-ips' with ID 'abc123' to view its current address list and lock token.

Scope: REGIONAL, IP Set Name: blocked-ips, IP Set ID: abc123

Links

Discussion