Route53GlobalResolver / Client / create_firewall_domain_list

create_firewall_domain_list

Route53GlobalResolver.Client.create_firewall_domain_list(**kwargs)

Creates a firewall domain list. Domain lists are reusable sets of domain specifications that you use in DNS firewall rules to allow, block, or alert on DNS queries to specific domains.

See also: AWS API Documentation

Request Syntax

response = client.create_firewall_domain_list(
    clientToken='string',
    globalResolverId='string',
    description='string',
    name='string',
    tags={
        'string': 'string'
    }
)
Parameters:
  • clientToken (string) –

    A unique, case-sensitive identifier to ensure idempotency. This means that making the same request multiple times with the same clientToken has the same result every time.

    This field is autopopulated if not provided.

  • globalResolverId (string) –

    [REQUIRED]

    The ID of the Route 53 Global Resolver that the domain list will be associated with.

  • description (string) – An optional description for the firewall domain list.

  • name (string) –

    [REQUIRED]

    A descriptive name for the firewall domain list.

  • tags (dict) –

    An array of user-defined keys and optional values. These tags can be used for categorization and organization.

    • (string) –

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'arn': 'string',
    'globalResolverId': 'string',
    'createdAt': datetime(2015, 1, 1),
    'description': 'string',
    'domainCount': 123,
    'id': 'string',
    'name': 'string',
    'status': 'CREATING'|'OPERATIONAL'|'UPDATING'|'DELETING',
    'updatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) –

    • arn (string) –

      An Amazon Resource Name (ARN) for the domain list.

    • globalResolverId (string) –

      The ID of the Route 53 Global Resolver that the domain list is associated with.

    • createdAt (datetime) –

      The time and date the domain list was created on.

    • description (string) –

      Description for the domain list.

    • domainCount (integer) –

      Number of domains in the domain list.

    • id (string) –

      ID of the domain list.

    • name (string) –

      Name of the domain list.

    • status (string) –

      Creation status of the domain list.

    • updatedAt (datetime) –

      The time and date the domain list was updated.

Exceptions

  • Route53GlobalResolver.Client.exceptions.InternalServerException

  • Route53GlobalResolver.Client.exceptions.ValidationException

  • Route53GlobalResolver.Client.exceptions.ConflictException

  • Route53GlobalResolver.Client.exceptions.ServiceQuotaExceededException

  • Route53GlobalResolver.Client.exceptions.AccessDeniedException

  • Route53GlobalResolver.Client.exceptions.ThrottlingException

  • Route53GlobalResolver.Client.exceptions.ResourceNotFoundException