CreateCidrCollection - Amazon Route 53
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


Creates a CIDR collection in the current Amazon 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 Amazon 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 Amazon SDKs, see the following: