WAFRegional / Client / list_ip_sets
list_ip_sets#
- WAFRegional.Client.list_ip_sets(**kwargs)#
Note
This is AWS WAF Classic documentation. For more information, see AWS WAF Classic in the developer guide.
For the latest version of AWS WAF , use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.
Returns an array of IPSetSummary objects in the response.
See also: AWS API Documentation
Request Syntax
response = client.list_ip_sets( NextMarker='string', Limit=123 )
- Parameters:
NextMarker (string) – AWS WAF returns a
NextMarker
value in the response that allows you to list another group ofIPSets
. For the second and subsequentListIPSets
requests, specify the value ofNextMarker
from the previous response to get information about another batch ofIPSets
.Limit (integer) – Specifies the number of
IPSet
objects that you want AWS WAF to return for this request. If you have moreIPSet
objects than the number you specify forLimit
, the response includes aNextMarker
value that you can use to get another batch ofIPSet
objects.
- Return type:
dict
- Returns:
Response Syntax
{ 'NextMarker': 'string', 'IPSets': [ { 'IPSetId': 'string', 'Name': 'string' }, ] }
Response Structure
(dict) –
NextMarker (string) –
To list more
IPSet
objects, submit anotherListIPSets
request, and in the next request use theNextMarker
response value as theNextMarker
value.IPSets (list) –
An array of IPSetSummary objects.
(dict) –
Note
This is AWS WAF Classic documentation. For more information, see AWS WAF Classic in the developer guide.
For the latest version of AWS WAF , use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.
Contains the identifier and the name of the
IPSet
.IPSetId (string) –
The
IPSetId
for an IPSet. You can useIPSetId
in a GetIPSet request to get detailed information about an IPSet.Name (string) –
A friendly name or description of the IPSet. You can’t change the name of an
IPSet
after you create it.
Exceptions
WAFRegional.Client.exceptions.WAFInternalErrorException
WAFRegional.Client.exceptions.WAFInvalidAccountException
Examples
The following example returns an array of up to 100 IP match sets.
response = client.list_ip_sets( Limit=100, ) print(response)
Expected Output:
{ 'IPSets': [ { 'IPSetId': 'abcd12f2-46da-4fdb-b8d5-fbd4c466928f', 'Name': 'MyIPSetFriendlyName', }, ], 'ResponseMetadata': { '...': '...', }, }