Deleting an Amazon Cloud Map namespace - Amazon Cloud Map
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Deleting an Amazon Cloud Map namespace

When you delete a namespace, you can no longer use it to register or discover service instances. Note the following:

  • Before you can delete a namespace, you must delete all the services that were created in the namespace. For more information, see Deleting an Amazon Cloud Map service.

  • Before you can delete a service, you must deregister all the service instances that were registered using the service. For more information, see Deregistering an Amazon Cloud Map service instance.

  • When you create a namespace, if you specify that you want to discover service instances using either public DNS queries or DNS queries in VPCs, Amazon Cloud Map creates an Amazon Route 53 public or private hosted zone. When you delete the namespace, Amazon Cloud Map deletes the corresponding hosted zone.

To delete a namespace, perform the following procedure.

Amazon Web Services Management Console
  1. Sign in to the Amazon Web Services Management Console and open the Amazon Cloud Map console at https://console.amazonaws.cn/cloudmap/.

  2. In the navigation pane, choose Namespaces.

  3. Select the namespace that you want to delete, then choose Delete.

  4. Confirm that you want to delete the service by choosing Delete again.

Amazon CLI
  • Delete a namespace with the delete-namespace command (replace the red value with your own). If the namespace still contains one or more services, the request fails.

    aws servicediscovery delete-namespace --id ns-xxxxxxxxxxx
Amazon SDK for Python (Boto3)
  1. If you don't already have Boto3 installed, you can find instructions for installing, configuring, and using Boto3 here.

  2. Import Boto3 and use servicediscovery as your service.

    import boto3 client = boto3.client('servicediscovery')
  3. Delete a namespace with delete_namespace() (replace the red value with your own). If the namespace still contains one or more services, the request fails.

    response = client.delete_namespace( Id='ns-xxxxxxxxxxx', ) # If you want to see the response print(response)

    Example response output

    { 'OperationId': 'gv4g5meo7ndmeh4fqskygvk23d2fijwa-k98y6drk', 'ResponseMetadata': { '...': '...', }, }