CreateCidrCollection - Amazon Route 53


Creates a CIDR collection in the current AWS account.

Request Syntax

POST /2013-04-01/cidrcollection HTTP/1.1 <?xml version="1.0" encoding="UTF-8"?> <CreateCidrCollectionRequest xmlns=""> <CallerReference>string</CallerReference> <Name>string</Name> </CreateCidrCollectionRequest>

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in XML format.


Root level tag for the CreateCidrCollectionRequest parameters.

Required: Yes


A client-specific token that allows requests to be securely retried so that the intended outcome will only occur once, retries receive a similar response, and there are no additional edge cases to handle.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: \p{ASCII}+

Required: Yes


A unique identifier for the account that can be used to reference the collection from other API calls.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [0-9A-Za-z_\-]+

Required: Yes

Response Syntax

HTTP/1.1 201 Location: Location <?xml version="1.0" encoding="UTF-8"?> <CreateCidrCollectionResponse> <Collection> <Arn>string</Arn> <Id>string</Id> <Name>string</Name> <Version>long</Version> </Collection> </CreateCidrCollectionResponse>

Response Elements

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

The response returns the following HTTP headers.


A unique URL that represents the location for the CIDR collection.

Length Constraints: Maximum length of 1024.

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


Root level tag for the CreateCidrCollectionResponse parameters.

Required: Yes


A complex type that contains information about the CIDR collection.

Type: CidrCollection object


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


A CIDR collection with this name and a different caller reference already exists in this account.

HTTP Status Code: 400


Another user submitted a request to create, update, or delete the object at the same time that you did. Retry the request.

HTTP Status Code: 400


The input is not valid.

HTTP Status Code: 400


This operation can't be completed because the current account has reached the limit on the resource you are trying to create. To request a higher limit, create a case with the AWS Support Center.

HTTP Status Code: 400


Example request

This example illustrates one usage of CreateCidrCollection.

POST /2013-04-01/cidrcollection <?xml version="1.0" encoding="UTF-8"?> <CreateCidrCollectionRequest xmlns=""> <Name>isp-city-cidrs</Name> <CallerReference>ref1</CallerReference> </CreateCidrCollectionRequest>

Example response

This example illustrates one usage of CreateCidrCollection.

HTTP/1.1 201 Created <?xml version="1.0"?> <CreateCidrCollectionResponse xmlns=""> <Collection> <Arn>arn:aws:route53:::cidrcollection/c8c02a84-aaaa-bbbb-e0d2-d833a2f80106</Arn> <Id>c8c02a84-aaaa-bbbb-e0d2-d833a2f80106</Id> <Name>isp-city-cidrs</Name> <Version>1</Version> </Collection> </CreateCidrCollectionResponse>

See Also

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