Deleting an AWS Cloud Map namespace - AWS Cloud Map

Deleting an AWS 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 AWS 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 AWS 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, AWS Cloud Map creates an Amazon RouteĀ 53 public or private hosted zone. When you delete the namespace, AWS Cloud Map deletes the corresponding hosted zone.

To delete a namespace, perform the following procedure.

AWS Management Console
  1. Sign in to the AWS Management Console and open the AWS Cloud Map console at https://console.aws.amazon.com/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.

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