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

# Gerenciar configurações de domínio
<a name="iot-custom-endpoints-managing"></a>

Este tópico aborda as principais operações para você gerenciar seus recursos de configuração de domínio. Você também pode gerenciar os ciclos de vida das configurações existentes usando as seguintes APIs: [ ListDomainConfigurations](https://docs.aws.amazon.com/iot/latest/apireference/API_ListDomainConfigurations.html),, e. [ DescribeDomainConfiguration ](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeDomainConfiguration.html) [ UpdateDomainConfiguration ](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateDomainConfiguration.html) [ DeleteDomainConfiguration ](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteDomainConfiguration.html)

**Topics**
+ [Visualizar configurações de domínio](#iot-custom-endpoints-managing-view)
+ [Atualizar configurações de domínio](#iot-custom-endpoints-managing-update)
+ [Excluir configurações de domínio](#iot-custom-endpoints-managing-delete)
+ [Renovação de certificados em domínios personalizados](#iot-custom-endpoints-managing-certificates)

## Visualizar configurações de domínio
<a name="iot-custom-endpoints-managing-view"></a>

Para retornar uma lista paginada de todas as configurações de domínio em sua Conta da AWS, use a API. [ ListDomainConfigurations ](https://docs.aws.amazon.com/iot/latest/apireference/API_ListDomainConfigurations.html) Você pode ver os detalhes de uma configuração de domínio específica usando a [ DescribeDomainConfiguration ](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeDomainConfiguration.html) API. Essa API usa um único parâmetro `domainConfigurationName` e retorna os detalhes da configuração especificada.

**Exemplo**

## Atualizar configurações de domínio
<a name="iot-custom-endpoints-managing-update"></a>

Para atualizar o status ou o autorizador personalizado da sua configuração de domínio, use a [ UpdateDomainConfiguration ](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateDomainConfiguration.html) API. É possível definir o status como `ENABLED` ou `DISABLED`. Se você desativar a configuração de domínio, os dispositivos conectados a esse domínio receberão um erro de autenticação. No momento, não é possível atualizar o certificado de servidor da configuração de domínio. Para alterar o certificado de uma configuração de domínio, é necessário excluí-la e recriá-la.

**Exemplo**

## Excluir configurações de domínio
<a name="iot-custom-endpoints-managing-delete"></a>

Antes de excluir uma configuração de domínio, use a [ UpdateDomainConfiguration ](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateDomainConfiguration.html) API para definir o status como`DISABLED`. Isso ajuda a evitar a exclusão acidental do endpoint. Depois de desativar a configuração do domínio, exclua-a usando a [ DeleteDomainConfiguration ](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteDomainConfiguration.html) API. Você deve colocar os domínios AWS gerenciados no `DISABLED` status por 7 dias antes de poder excluí-los. É possível colocar domínios personalizados no status `DISABLED` e depois excluí-los de uma só vez.

**Exemplo**

Depois de excluir uma configuração de domínio, AWS IoT Core não serve mais o certificado de servidor associado a esse domínio personalizado.

## Renovação de certificados em domínios personalizados
<a name="iot-custom-endpoints-managing-certificates"></a>

Talvez seja necessário substituir periodicamente o certificado do servidor por um atualizado. A taxa na qual você faz isso depende do período de validade do certificado. Se você gerou o certificado de servidor usando o Gerenciador de certificados da AWS (ACM), é possível configurar o certificado para ser renovado automaticamente. Quando o ACM renova seu certificado, ele AWS IoT Core recebe automaticamente o novo certificado. Não é necessário realizar nenhuma ação adicional. Se você importou o certificado do servidor de uma origem diferente, poderá alterná-lo reimportando-o para o ACM. Para ver informações sobre a reimportação de certificados, consulte [Reimportar um certificado](https://docs.aws.amazon.com/acm/latest/userguide/import-reimport.html).

**nota**  
AWS IoT Core só recebe atualizações de certificados nas seguintes condições.  
O novo certificado tem o mesmo ARN do antigo.
O novo certificado tem o mesmo algoritmo de assinatura, nome comum ou nome alternativo do assunto que o antigo.