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