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.

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