

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Cancelando o registro de uma instância de serviço AWS Cloud Map
<a name="deregistering-instances"></a>

Para poder excluir um serviço, você deve cancelar o registro de todas as instâncias de serviço que foram registradas usando o serviço.

Para cancelar o registro de uma instância de serviço, execute o procedimento a seguir.

------
#### [ Console de gerenciamento da AWS ]

1. Faça login no Console de gerenciamento da AWS e abra o AWS Cloud Map console em [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/).

1. No painel de navegação, escolha **Namespaces**.

1. Escolha a opção do namespace que contém a instância de serviço da qual você deseja cancelar o registro.

1. Na *namespace-name* página **Namespace:**, escolha o serviço que você usou para registrar a instância do serviço.

1. Na *service-name* página **Serviço:**, escolha a instância de serviço que você deseja cancelar o registro.

1. Escolha **Cancelar registro**.

1. Confirme se você deseja cancelar o registro da instância de serviço.

------
#### [ AWS CLI ]
+ Cancele o registro de uma instância de serviço com o `[deregister-instance](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/deregister-instance.html)` comando (substitua os *red* valores pelos seus). Esse comando exclui os registros DNS do Amazon Route 53 e todas as verificações de saúde AWS Cloud Map criadas para a instância especificada.

  ```
  aws servicediscovery deregister-instance \
      --service-id srv-xxxxxxxxx \
      --instance-id myservice-53
  ```

------
#### [ AWS SDK for Python (Boto3) ]

1. Caso ainda não tenha instalado `Boto3`, é possível encontrar instruções para instalação, configuração e uso do `Boto3` [aqui](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation).

1. Importe `Boto3` e use `servicediscovery` como seu serviço.

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

1. Cancele o registro de uma instância de serviço com `deregister-instance()` (substitua *red* os valores pelos seus). Esse comando exclui os registros DNS do Amazon Route 53 e todas as verificações de saúde AWS Cloud Map criadas para a instância especificada.

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

   Exemplo de objeto de resposta

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

------