Amazon SimpleDB
Developer Guide (API Version 2009-04-15)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.



The CreateDomain operation creates a new domain. The domain name must be unique among the domains associated with the Access Key ID provided in the request. The CreateDomain operation might take 10 or more seconds to complete.


CreateDomain is an idempotent operation; running it multiple times using the same domain name will not result in an error response.

You can create up to 250 domains per account.

If you require additional domains, go to

Request Parameters

Name Description Required

The name of the domain to create. The name can range between 3 and 255 characters and can contain the following characters: a-z, A-Z, 0-9, '_', '-', and '.'.

Type: String


Response Elements

See Common Response Elements.

Special Errors

Error Description
InvalidParameterValue Value (" + value + ") for parameter DomainName is invalid.
MissingParameter The request must contain the parameter DomainName.
NumberDomainsExceeded Number of domains limit exceeded.


Sample Request ?Action=CreateDomain &AWSAccessKeyId=[valid access key id] &DomainName=MyDomain &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Timestamp=2010-01-25T15%3A01%3A28-07%3A00 &Version=2009-04-15 &Signature=[valid signature]

Sample Response

<CreateDomainResponse> <ResponseMetadata> <RequestId>2a1305a2-ed1c-43fc-b7c4-e6966b5e2727</RequestId> <BoxUsage>0.0000219907</BoxUsage> </ResponseMetadata> </CreateDomainResponse>