Route53GlobalResolver / Client / list_global_resolvers

list_global_resolvers

Route53GlobalResolver.Client.list_global_resolvers(**kwargs)

Lists all Route 53 Global Resolver instances in your account with pagination support.

Warning

Route 53 Global Resolver is a global service that supports resolvers in multiple Amazon Web Services Regions but you must specify the US East (Ohio) Region to create, update, or otherwise work with Route 53 Global Resolver resources. That is, for example, specify --region us-east-2 on Amazon Web Services CLI commands.

See also: AWS API Documentation

Request Syntax

response = client.list_global_resolvers(
    maxResults=123,
    nextToken='string'
)

Parameters:

• maxResults (integer) – The maximum number of Route 53 Global Resolver instances to return in the response. Valid range is 1-100.

• nextToken (string) – The token for the next page of results. This value is returned in the response if there are more results to retrieve.

Return type:

dict

Returns:

Response Syntax

{
    'nextToken': 'string',
    'globalResolvers': [
        {
            'id': 'string',
            'arn': 'string',
            'clientToken': 'string',
            'dnsName': 'string',
            'observabilityRegion': 'string',
            'name': 'string',
            'description': 'string',
            'regions': [
                'string',
            ],
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1),
            'status': 'CREATING'|'OPERATIONAL'|'UPDATING'|'DELETING',
            'ipv4Addresses': [
                'string',
            ],
            'ipv6Addresses': [
                'string',
            ],
            'ipAddressType': 'IPV4'|'DUAL_STACK'
        },
    ]
}

Response Structure

• (dict) –

  • nextToken (string) –

    A pagination token used for large sets of results that can’t be returned in a single response. Provide this token in the next call to get the results not returned in this call.

  • globalResolvers (list) –

    Paginated list of Global Resolvers.

    • (dict) –

      Summary information about a global resolver.

      • id (string) –

        The unique identifier of the global resolver.

      • arn (string) –

        The Amazon Resource Name (ARN) of the global resolver.

      • clientToken (string) –

        The unique string that identifies the request and ensures idempotency.

      • dnsName (string) –

        The DNS name of the global resolver.

      • observabilityRegion (string) –

        The Amazon Web Services Region where observability data is collected for the global resolver.

      • name (string) –

        The name of the global resolver.

      • description (string) –

        A description of the global resolver.

      • regions (list) –

        The Amazon Web Services Regions where the global resolver is deployed.

        • (string) –

      • createdAt (datetime) –

        The date and time when the global resolver was created.

      • updatedAt (datetime) –

        The date and time when the global resolver was last updated.

      • status (string) –

        The current status of the global resolver.

      • ipv4Addresses (list) –

        The IPv4 addresses assigned to the global resolver.

        • (string) –

      • ipv6Addresses (list) –

        The IPv6 addresses assigned to the global resolver. This field is only populated when ipAddressType is DUAL_STACK.

        • (string) –

      • ipAddressType (string) –

        The IP address type configured for the global resolver.

Exceptions

• Route53GlobalResolver.Client.exceptions.InternalServerException

• Route53GlobalResolver.Client.exceptions.ValidationException

• Route53GlobalResolver.Client.exceptions.AccessDeniedException

• Route53GlobalResolver.Client.exceptions.ThrottlingException