CreateDomain

Description

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.

[Note]Note

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 100 domains per account.

Request Parameters

Name Description Required?
DomainName

The name of the domain to create.

Type: String

Yes

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.

Examples

Sample Request

https://sdb.amazonaws.com/
?Action=CreateDomain
&AWSAccessKeyId=[valid access key id]
&DomainName=MyDomain
&SignatureVersion=1
&Timestamp=2007-06-25T15%3A01%3A28-07%3A00
&Version=2007-11-07
&Signature=hvH87q32QzGbDba6bm9YUEVpiGQ%3D

Sample Response

<CreateDomainResponse xmlns="http://sdb.amazonaws.com/doc/2007-11-07">
  <ResponseMetadata>
    <RequestId>2a1305a2-ed1c-43fc-b7c4-e6966b5e2727</RequestId>
    <BoxUsage>0.0000219907</BoxUsage>
  </ResponseMetadata>
</CreateDomainResponse>