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 o seguinte APIs: [ListDomainConfigurations](https://docs.aws.amazon.com/iot/latest/apireference/API_ListDomainConfigurations.html),, e. [DescribeDomainConfiguration[UpdateDomainConfiguration[DeleteDomainConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteDomainConfiguration.html)](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateDomainConfiguration.html)](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeDomainConfiguration.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 seu 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 configuração do seu 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 em `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, o certificado do servidor associado a esse domínio personalizado AWS IoT Core não é mais exibido.

## 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 AWS Certificate Manager (ACM), é possível configurar o certificado para ser renovado automaticamente. Quando o ACM renova seu certificado, pega AWS IoT Core 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ó coleta atualizações de certificados sob as 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.