Deregistering an Amazon Cloud Map service instance - 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).

Deregistering an Amazon Cloud Map service instance

Before you can delete a service, you must deregister all service instances that were registered using the service.

To deregister a service instance, 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 contains the service instance that you want to deregister.

  4. On the Namespace: namespace-name page, choose the option for the service you used to register the service instance.

  5. On the Service: service-name page, choose the option for the service instance that you want to deregister.

  6. Choose Deregister.

  7. Confirm that you want to deregister the service instance.

Amazon CLI
  • Deregister a service instance with the deregister-instance command (replace the red values with your own). This command deletes the Amazon Route 53 DNS records and any health checks that Amazon Cloud Map created for the specified instance.

    aws servicediscovery deregister-instance \ --service-id srv-xxxxxxxxx \ --instance-id myservice-53
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. Deregister a service instance with deregister-instance() (replace the red values with your own). This command deletes the Amazon Route 53 DNS records and any health checks that Amazon Cloud Map created for the specified instance.

    response = client.deregister_instance( InstanceId='myservice-53', ServiceId='srv-xxxxxxxxx', ) # If you want to see the response print(response)

    Example response output

    { 'OperationId': '4yejorelbukcjzpnr6tlmrghsjwpngf4-k98rnaiq', 'ResponseMetadata': { '...': '...', }, }