Amazon CloudSearch
Developer Guide (API Version 2013-01-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. You will still be charged for a domain even if it does not contain any documents—deleting all documents does not delete the domain. 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.

Deleting a Domain Using the Amazon CloudSearch Console

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

To delete a domain

  1. Sign in to the AWS Management Console and open the Amazon CloudSearch console.

  2. In the Navigation pane, 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.

Deleting a Domain Using the Amazon CloudSearch 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 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

Deleting Amazon CloudSearch Domains Using the AWS SDKs

The AWS SDKs (except the Android and iOS SDKs) support all of the Amazon CloudSearch actions defined in the Amazon CloudSearch Configuration API, including DeleteDomain. For more information about installing and using the AWS SDKs, see AWS Software Development Kits.