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

*********************
associate_hosted_zone
*********************



.. py:method:: Route53GlobalResolver.Client.associate_hosted_zone(**kwargs)

  

  Associates a Route 53 private hosted zone with a Route 53 Global Resolver resource. This allows the resolver to resolve DNS queries for the private hosted zone from anywhere globally.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/route53globalresolver-2022-09-27/AssociateHostedZone>`_  


  **Request Syntax**
  ::

    response = client.associate_hosted_zone(
        hostedZoneId='string',
        resourceArn='string',
        name='string'
    )
    
  :type hostedZoneId: string
  :param hostedZoneId: **[REQUIRED]** 

    The ID of the Route 53 private hosted zone to associate with the Route 53 Global Resolver resource.

    

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

    An Amazon Resource Name (ARN) of the Route 53 Global Resolver the private hosted zone will be associated to.

    

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

    Name for the private hosted zone association.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'id': 'string',
          'resourceArn': 'string',
          'hostedZoneId': 'string',
          'hostedZoneName': 'string',
          'name': 'string',
          'createdAt': datetime(2015, 1, 1),
          'updatedAt': datetime(2015, 1, 1),
          'status': 'CREATING'|'OPERATIONAL'|'DELETING'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **id** *(string) --* 

        ID of the association.

        
      

      - **resourceArn** *(string) --* 

        An Amazon Resource Name (ARN) of the Route 53 Global Resolver the private hosted zone is associated to.

        
      

      - **hostedZoneId** *(string) --* 

        ID of the private hosted zone.

        
      

      - **hostedZoneName** *(string) --* 

        Name of the hosted zone (also the domain associated with the hosted zone).

        
      

      - **name** *(string) --* 

        Name for the private hosted zone association.

        
      

      - **createdAt** *(datetime) --* 

        The date and time the private hosted zone association was created.

        
      

      - **updatedAt** *(datetime) --* 

        The date and time the private hosted zone association was modified.

        
      

      - **status** *(string) --* 

        Aggregate status for all the AWS Regions in which the Route 53 Global Resolver exists.

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

  