Route53Resolver / Client / list_firewall_domains

list_firewall_domains#

Route53Resolver.Client.list_firewall_domains(**kwargs)#

Retrieves the domains that you have defined for the specified firewall domain list.

A single call might return only a partial list of the domains. For information, see MaxResults.

See also: AWS API Documentation

Request Syntax

response = client.list_firewall_domains(
    FirewallDomainListId='string',
    MaxResults=123,
    NextToken='string'
)
Parameters:
  • FirewallDomainListId (string) –

    [REQUIRED]

    The ID of the domain list whose domains you want to retrieve.

  • MaxResults (integer) –

    The maximum number of objects that you want Resolver to return for this request. If more objects are available, in the response, Resolver provides a NextToken value that you can use in a subsequent call to get the next batch of objects.

    If you don’t specify a value for MaxResults, Resolver returns up to 100 objects.

  • NextToken (string) –

    For the first call to this list request, omit this value.

    When you request a list of objects, Resolver returns at most the number of objects specified in MaxResults. If more objects are available for retrieval, Resolver returns a NextToken value in the response. To retrieve the next batch of objects, use the token that was returned for the prior request in your next request.

Return type:

dict

Returns:

Response Syntax

{
    'NextToken': 'string',
    'Domains': [
        'string',
    ]
}

Response Structure

  • (dict) –

    • NextToken (string) –

      If objects are still available for retrieval, Resolver returns this token in the response. To retrieve the next batch of objects, provide this token in your next request.

    • Domains (list) –

      A list of the domains in the firewall domain list.

      This might be a partial list of the domains that you’ve defined in the domain list. For information, see MaxResults.

      • (string) –

Exceptions

  • Route53Resolver.Client.exceptions.ResourceNotFoundException

  • Route53Resolver.Client.exceptions.ValidationException

  • Route53Resolver.Client.exceptions.AccessDeniedException

  • Route53Resolver.Client.exceptions.InternalServiceErrorException

  • Route53Resolver.Client.exceptions.ThrottlingException