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

É possível gerenciar os ciclos de vida de configurações existentes usando as APIs a seguir.

Visualizar configurações de domínio

Para retornar uma lista paginada de todas as configurações de domínio em seu Conta da AWS, use a API. ListDomainConfigurations Você pode ver os detalhes de uma configuração de domínio específica usando a DescribeDomainConfigurationAPI. Essa API usa um único parâmetro domainConfigurationName e retorna os detalhes da configuração especificada.

Exemplo

Atualizar configurações de domínio

Para atualizar o status ou o autorizador personalizado da configuração do seu domínio, use a UpdateDomainConfigurationAPI. É 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

Antes de excluir uma configuração de domínio, use a UpdateDomainConfigurationAPI para definir o status comoDISABLED. Isso ajuda a evitar a exclusão acidental do endpoint. Depois de desativar a configuração do domínio, exclua-a usando a DeleteDomainConfigurationAPI. Você deve colocar os domínios AWS gerenciados em DISABLED status por 7 dias antes de poder excluí-los. Você pode colocar domínios personalizados em DISABLED status 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

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.