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

***************************
create_firewall_domain_list
***************************



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


  **Request Syntax**
  ::

    response = client.create_firewall_domain_list(
        clientToken='string',
        globalResolverId='string',
        description='string',
        name='string',
        tags={
            'string': 'string'
        }
    )
    
  :type clientToken: string
  :param clientToken: 

    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.

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

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

    

  
  :type description: string
  :param description: 

    An optional description for the firewall domain list.

    

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

    A descriptive name for the firewall domain list.

    

  
  :type tags: dict
  :param tags: 

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

    

  
    - *(string) --* 

    
      - *(string) --* 

      


  
  :rtype: 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**
  
  *   :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`

  