:doc:`Route53GlobalResolver <../../route53globalresolver>` / Client / create_dns_view

***************
create_dns_view
***************



.. py:method:: 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 <https://docs.aws.amazon.com/goto/WebAPI/route53globalresolver-2022-09-27/CreateDNSView>`_  


  **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'
        }
    )
    
  :type globalResolverId: string
  :param globalResolverId: **[REQUIRED]** 

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

    

  
  :type clientToken: string
  :param clientToken: 

    A unique string that identifies the request and ensures idempotency.

    This field is autopopulated if not provided.

  
  :type name: string
  :param name: **[REQUIRED]** 

    A descriptive name for the DNS view.

    

  
  :type dnssecValidation: string
  :param dnssecValidation: 

    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.

    

  
  :type ednsClientSubnet: string
  :param ednsClientSubnet: 

    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.

    

  
  :type firewallRulesFailOpen: string
  :param firewallRulesFailOpen: 

    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.

    

  
  :type description: string
  :param description: 

    An optional description for the DNS view.

    

  
  :type tags: dict
  :param tags: 

    Tags to associate with the DNS view.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


  
  :rtype: 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**
  
  *   :py:class:`Route53GlobalResolver.Client.exceptions.InternalServerException`

  
  *   :py:class:`Route53GlobalResolver.Client.exceptions.ValidationException`

  
  *   :py:class:`Route53GlobalResolver.Client.exceptions.ConflictException`

  
  *   :py:class:`Route53GlobalResolver.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`Route53GlobalResolver.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`Route53GlobalResolver.Client.exceptions.ThrottlingException`

  
  *   :py:class:`Route53GlobalResolver.Client.exceptions.ResourceNotFoundException`

  