Page Comparison

...

...

Overview

The following operations allow you to work with domains. Click an operation name to see details on how to use it.

For a sample proxy service that illustrates how to work with domains, see Sample configuration.

Operation details

This section provides details on the operations.

Anchor
createDomain createDomain

 Creating a domain

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. This operation might take 10 or more seconds to complete.

...

<amazonsimpledb.createDomain>
	<domainName>{$ctx:domainName}</domainName>
</amazonsimpledb.createDomain>

Property

• domainName: Required - The name of the domain to be created. The name can range between 3 and 255 characters and can contain the following characters: a-z, A-Z, 0-9, "_", "-", and ".".

Anchor
request request

Sample request

Following is a sample REST/XML request that can be handled by the createDomain operation.

<root>
	<apiUrl>https://sdb.amazonaws.com</apiUrl>
	<accessKeyId>AKIAIYMUNCUHQdfJEFMURA</accessKeyId>
	<secretAccessKey>qAb5n5hAYdfgzpgcD2+7APuEVg3rLtpkkEuTj2zjGOg</secretAccessKey>
	<action>CreateDomain</action>
	<version>2009-04-15</version>
	<signatureVersion>2</signatureVersion>
	<signatureMethod>HmacSHA1</signatureMethod>
	<domainName>Name</domainName>
</root>

Related Amazon SimpleDB documentation

http://docs.aws.amazon.com/AmazonSimpleDB/latest/DeveloperGuide/SDB_API_CreateDomain.html

Anchor
deleteDomain deleteDomain

 Deleting a domain

The deleteDomain operation deletes a domain. Any items (and their attributes) in the domain will also be deleted. This operation might take 10 or more seconds to complete.

...

<amazonsimpledb.deleteDomain>
	<domainName>{$ctx:domainName}</domainName>
</amazonsimpledb.deleteDomain>

Property

• domainName: Required - Name of the domain to be deleted.

Sample request

Following is a sample REST/XML request that can be handled by the deleteDomain operation.

<root>
	<apiUrl>https://sdb.amazonaws.com</apiUrl>
	<accessKeyId>AKIAIYMUdfgNCUHQJEFMURA</accessKeyId>
	<secretAccessKey>qAb5n5sghAYzpgcD2+7APuEVg3rLtpkkEuTj2zjGOg</secretAccessKey>
	<action>DeleteDomain</action>
	<version>2009-04-15</version>
	<signatureVersion>2</signatureVersion>
	<signatureMethod>HmacSHA1</signatureMethod>
	<domainName>Name</domainName>
</root>

Related Amazon SimpleDB documentation

http://docs.aws.amazon.com/AmazonSimpleDB/latest/DeveloperGuide/SDB_API_DeleteDomain.html

Anchor
listDomains listDomains

 Listing domains

The listDomains operation lists all domains associated with the Access Key ID.

<amazonsimpledb.listDomains>
	<maxNumberOfDomains>{$ctx:maxNumberOfDomains}</maxNumberOfDomains>
    <nextToken>{$ctx:nextToken}</nextToken>
</amazonsimpledb.listDomains> 

Properties

• maxNumberOfDomains: Optional - The maximum number of domain names to be returned. The range is 1 to 100. Default is 100.
• nextToken: Optional - String that tells Amazon SimpleDB where to start the next list of domain names.

Sample request

Following is a sample REST/XML request that can be handled by the listDomains operation.

<root>
	<apiUrl>https://sdb.amazonaws.com</apiUrl>
	<accessKeyId>AKIAIYMUNCfgUHQJEFMURA</accessKeyId>
	<secretAccessKey>qAb5n5hAYfgzpgcD2+7APuEVg3rLtpkkEuTj2zjGfOg</secretAccessKey>
	<action>ListDomains</action>
	<version>2009-04-15</version>
	<signatureVersion>2</signatureVersion>
	<signatureMethod>HmacSHA1</signatureMethod>
	<maxNumberOfDomains>5</maxNumberOfDomains>
	<nextToken>1</nextToken>
</root>

Related Amazon SimpleDB documentation

http://docs.aws.amazon.com/AmazonSimpleDB/latest/DeveloperGuide/SDB_API_ListDomains.html

Sample configuration

Following is a sample proxy service that illustrates how to connect to Amazon SimpleDB with the init operation and use the createDomain operation. The sample request for this proxy can be found in createDomain sample request. You can use this sample as a template for using other operations in this category.

...