Deleting Namespaces - 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 Namespaces

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 Services.

  • Before you can delete a service, you must deregister all the service instances that were registered using the service. For more information, see Deregistering Service Instances.

  • 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. Choose the option for the namespace that you want to delete.

  4. Choose Delete.

  5. Confirm that you want to delete the service.

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': {
        '...': '...',
    },
}