Amazon CloudSearch
Developer Guide (API Version 2011-02-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

Deleting an Amazon CloudSearch Domain

If you are no longer using a search domain, you must delete it to avoid incurring additional usage fees. Deleting a domain deletes the index associated with the domain and takes the domain's document and search endpoints offline permanently. It can take several minutes to completely remove a domain and all of its resources.

You can delete a domain using the cs-delete-domain command, from the Amazon CloudSearch console, or using the DeleteDomain configuration action.

Command Line Tools

You use the cs-delete-domain command to delete a search domain and all of its resources. For information about installing and setting up the Amazon CloudSearch command line tools, see Amazon CloudSearch Command Line Tool Reference.

To delete a domain

  1. Run the cs-delete-domain command and specify the name of the domain you want to delete. For example, to delete the movies domain:

    cs-delete-domain --domain-name movies  
  2. When prompted, enter y to confirm that you want to delete the domain.

    Really delete [movies] (y/N): y

AWS Management Console

You can easily delete a domain from the domain dashboard in the Amazon CloudSearch console.

To delete a domain

  1. Go to the Amazon CloudSearch console at https://console.aws.amazon.com/cloudsearch/home.

  2. In the Navigation panel, click the name of the domain you want to delete.

  3. On the Domain Dashboard, click the Delete this Domain button.

  4. In the Delete Domain dialog box, enable the checkbox and click OK to confirm that you want to delete the domain.

API

You use the DeleteDomain configuration action to remove a domain and all of its resources. The domain you want to delete is specified in the DomainName parameter. For example, to delete the movies domain:

https://cloudsearch.us-east-1.amazonaws.com
?Action=DeleteDomain
&DomainName=movies
&Version=2011-02-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120330/us-east-1/cloudsearch/aws4_request
&X-Amz-Date=2012-03-30T20:39:24.716Z
&X-Amz-SignedHeaders=host
&X-Amz-Signature=d17fcb306c5466cba0264d911889b4408082767a68afc8635a613d9f
c6196a9f

Note

Amazon CloudSearch configuration requests are authenticated using your AWS credentials. For more information about signing requests, see Request Authentication.