# Deregistering an Amazon Cloud Map service instance
<a name="deregistering-instances"></a>

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/](https://console.amazonaws.cn/cloudmap/).

1. In the navigation pane, choose **Namespaces**.

1. Choose the option for the namespace that contains the service instance that you want to deregister.

1. On the **Namespace: *namespace-name*** page, choose the service you used to register the service instance.

1. On the **Service: *service-name*** page, choose the service instance that you want to deregister.

1. Choose **Deregister**.

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

------
#### [ Amazon CLI ]
+ Deregister a service instance with the `[deregister-instance](https://docs.amazonaws.cn/cli/latest/reference/servicediscovery/deregister-instance.html)` 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](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation).

1. Import `Boto3` and use `servicediscovery` as your service.

   ```
   import boto3
   client = boto3.client('servicediscovery')
   ```

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

------