Gerenciar configurações de domínio

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,, e. DescribeDomainConfigurationUpdateDomainConfigurationDeleteDomainConfiguration

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