CreateDomain - Amazon SimpleDB



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>