GetHostedZoneLimit - Amazon Route 53

GetHostedZoneLimit

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 in the Amazon Route 53 Developer Guide. To request a higher limit, open a case.

Request Syntax

GET /2013-04-01/hostedzonelimit/Id/Type HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

Id

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

Length Constraints: Maximum length of 32.

Required: Yes

Type

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.

Valid Values: MAX_RRSETS_BY_ZONE | MAX_VPCS_ASSOCIATED_BY_ZONE

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 <?xml version="1.0" encoding="UTF-8"?> <GetHostedZoneLimitResponse> <Count>long</Count> <Limit> <Type>string</Type> <Value>long</Value> </Limit> </GetHostedZoneLimitResponse>

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in XML format by the service.

GetHostedZoneLimitResponse

Root level tag for the GetHostedZoneLimitResponse parameters.

Required: Yes

Count

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.

Type: Long

Valid Range: Minimum value of 0.

Limit

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: HostedZoneLimit object

Errors

For information about the errors that are common to all actions, see Common Errors.

HostedZoneNotPrivate

The specified hosted zone is a public hosted zone, not a private hosted zone.

HTTP Status Code: 400

InvalidInput

The input is not valid.

HTTP Status Code: 400

NoSuchHostedZone

No hosted zone exists with the ID that you specified.

HTTP Status Code: 404

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: