Route53GlobalResolver / Client / create_dns_view

create_dns_view

Route53GlobalResolver.Client.create_dns_view(**kwargs)

Creates a DNS view within a Route 53 Global Resolver. A DNS view models end users, user groups, networks, and devices, and serves as a parent resource that holds configurations controlling access, authorization, DNS firewall rules, and forwarding rules.

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.create_dns_view(
    globalResolverId='string',
    clientToken='string',
    name='string',
    dnssecValidation='ENABLED'|'DISABLED',
    ednsClientSubnet='ENABLED'|'DISABLED',
    firewallRulesFailOpen='ENABLED'|'DISABLED',
    description='string',
    tags={
        'string': 'string'
    }
)

Parameters:

• globalResolverId (string) –

  [REQUIRED]

  The ID of the Route 53 Global Resolver to associate with this DNS view.

• clientToken (string) –

  A unique string that identifies the request and ensures idempotency.

  This field is autopopulated if not provided.

• name (string) –

  [REQUIRED]

  A descriptive name for the DNS view.

• dnssecValidation (string) – Whether to enable DNSSEC validation for DNS queries in this DNS view. When enabled, the resolver verifies the authenticity and integrity of DNS responses from public name servers for DNSSEC-signed domains.

• ednsClientSubnet (string) – Whether to enable EDNS Client Subnet injection for DNS queries in this DNS view. When enabled, client subnet information is forwarded to provide more accurate geographic-based DNS responses.

• firewallRulesFailOpen (string) – Determines the behavior when Route 53 Global Resolver cannot apply DNS firewall rules due to service impairment. When enabled, DNS queries are allowed through; when disabled, queries are blocked.

• description (string) – An optional description for the DNS view.

• tags (dict) –

  Tags to associate with the DNS view.

  • (string) –

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'id': 'string',
    'arn': 'string',
    'clientToken': 'string',
    'dnssecValidation': 'ENABLED'|'DISABLED',
    'ednsClientSubnet': 'ENABLED'|'DISABLED',
    'firewallRulesFailOpen': 'ENABLED'|'DISABLED',
    'name': 'string',
    'description': 'string',
    'globalResolverId': 'string',
    'createdAt': datetime(2015, 1, 1),
    'updatedAt': datetime(2015, 1, 1),
    'status': 'CREATING'|'OPERATIONAL'|'UPDATING'|'ENABLING'|'DISABLING'|'DISABLED'|'DELETING'
}

Response Structure

• (dict) –

  • id (string) –

    The unique identifier for the DNS view.

  • arn (string) –

    The Amazon Resource Name (ARN) of the DNS view.

  • clientToken (string) –

    The unique string that identifies the request and ensures idempotency.

  • dnssecValidation (string) –

    Whether DNSSEC validation is enabled for DNS queries in this DNS view.

  • ednsClientSubnet (string) –

    Whether EDNS Client Subnet injection is enabled for DNS queries in this DNS view.

  • firewallRulesFailOpen (string) –

    The behavior when Route 53 Global Resolver cannot apply DNS firewall rules due to service impairment.

  • name (string) –

    The descriptive name of the DNS view.

  • description (string) –

    The description of the DNS view.

  • globalResolverId (string) –

    The ID of the Route 53 Global Resolver instance the DNS view is created for.

  • createdAt (datetime) –

    The date and time when the DNS view was created.

  • updatedAt (datetime) –

    The date and time when the DNS view was last updated.

  • status (string) –

    The operational status of the DNS view.

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