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á.
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 seguinteAPIs: ListDomainConfigurations,, e. DescribeDomainConfigurationUpdateDomainConfigurationDeleteDomainConfiguration
Neste tópico:
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 o. ListDomainConfigurationsAPI Você pode ver os detalhes de uma configuração de domínio específica usando DescribeDomainConfigurationAPIo. Isso API usa um único domainConfigurationName parâmetro 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 o. 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 o UpdateDomainConfigurationAPIpara 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 DeleteDomainConfigurationAPIo. 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
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 seu certificado de servidor usando AWS Certificate Manager (ACM), você pode configurar o certificado para ser renovado automaticamente. Quando ACM renova seu certificado, pega AWS IoT Core automaticamente o novo certificado. Não é necessário realizar nenhuma ação adicional. Se você importou seu certificado de servidor de uma fonte diferente, você pode alterná-lo reimportando-o para. 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 ARN mesmo que o antigo.
O novo certificado tem o mesmo algoritmo de assinatura, nome comum ou nome alternativo do assunto que o antigo.
