:doc:`Route53 <../../route53>` / Client / get_hosted_zone_limit

*********************
get_hosted_zone_limit
*********************



.. py:method:: Route53.Client.get_hosted_zone_limit(**kwargs)

  

  Gets the specified limit for a specified hosted zone, for example, the maximum number of records that you can create in the hosted zone.

   

  For the default limit, see `Limits <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html>`__ in the *Amazon Route 53 Developer Guide*. To request a higher limit, `open a case <https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-route53>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/route53-2013-04-01/GetHostedZoneLimit>`_  


  **Request Syntax**
  ::

    response = client.get_hosted_zone_limit(
        Type='MAX_RRSETS_BY_ZONE'|'MAX_VPCS_ASSOCIATED_BY_ZONE',
        HostedZoneId='string'
    )
    
  :type Type: string
  :param Type: **[REQUIRED]** 

    The limit that you want to get. Valid values include the following:

     

    
    * **MAX_RRSETS_BY_ZONE**: The maximum number of records that you can create in the specified hosted zone.
     
    * **MAX_VPCS_ASSOCIATED_BY_ZONE**: The maximum number of Amazon VPCs that you can associate with the specified private hosted zone.
    

    

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

    The ID of the hosted zone that you want to get a limit for.

    

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

    
    ::

      {
          'Limit': {
              'Type': 'MAX_RRSETS_BY_ZONE'|'MAX_VPCS_ASSOCIATED_BY_ZONE',
              'Value': 123
          },
          'Count': 123
      }
      
    **Response Structure**

    

    - *(dict) --* 

      A complex type that contains the requested limit.

      
      

      - **Limit** *(dict) --* 

        The current setting for the specified limit. For example, if you specified ``MAX_RRSETS_BY_ZONE`` for the value of ``Type`` in the request, the value of ``Limit`` is the maximum number of records that you can create in the specified hosted zone.

        
        

        - **Type** *(string) --* 

          The limit that you requested. Valid values include the following:

           

          
          * **MAX_RRSETS_BY_ZONE**: The maximum number of records that you can create in the specified hosted zone.
           
          * **MAX_VPCS_ASSOCIATED_BY_ZONE**: The maximum number of Amazon VPCs that you can associate with the specified private hosted zone.
          

          
        

        - **Value** *(integer) --* 

          The current value for the limit that is specified by ``Type``.

          
    
      

      - **Count** *(integer) --* 

        The current number of entities that you have created of the specified type. For example, if you specified ``MAX_RRSETS_BY_ZONE`` for the value of ``Type`` in the request, the value of ``Count`` is the current number of records that you have created in the specified hosted zone.

        
  
  **Exceptions**
  
  *   :py:class:`Route53.Client.exceptions.NoSuchHostedZone`

  
  *   :py:class:`Route53.Client.exceptions.InvalidInput`

  
  *   :py:class:`Route53.Client.exceptions.HostedZoneNotPrivate`

  