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 some time to completely remove a domain and all of its resources. Small domains are typically deleted in a few minutes, while it might take several hours to decommission all of the resources for a large domain. During this process, the domain status is set to BEING DELETED.

You can delete a domain from the Amazon CloudSearch console, using the aws cloudsearch delete-domain command, or using the AWS SDKs.

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 at https://console.aws.amazon.com/cloudsearch/home.

  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 AWS CLI

You use the aws cloudsearch delete-domain command to delete a search domain and all of its resources. For information about installing and setting up the AWS CLI, see the AWS Command Line Interface User Guide.

Note

If you are using the 2.0.0.1 version of the Amazon CloudSearch command line tools, you can use the cs-delete-domain command to delete a search domain. However, we recommend that you migrate to the AWS CLI, which provides a cross-service CLI with a simplified installation, unified configuration, and consistent command line syntax.

To delete a domain

  • Run the aws cloudsearch delete-domain command and specify the name of the domain you want to delete. For example, to delete the movies domain, you specify --domain-name movies.

    aws cloudsearch delete-domain --domain-name movies  

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.