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

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

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.