Gestione delle configurazioni di dominio - AWS IoT Core

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Gestione delle configurazioni di dominio

Questo argomento tratta le operazioni chiave per la gestione delle risorse di configurazione del dominio. È inoltre possibile gestire i cicli di vita delle configurazioni esistenti utilizzando quanto segueAPIs: ListDomainConfigurations,, DescribeDomainConfiguratione. UpdateDomainConfigurationDeleteDomainConfiguration

Visualizzazione delle configurazioni del dominio

Per restituire un elenco impaginato di tutte le configurazioni di dominio presenti nel tuo, usa il. Account AWSListDomainConfigurationsAPI È possibile visualizzare i dettagli di una particolare configurazione di dominio utilizzando il. DescribeDomainConfigurationAPI Questo API richiede un singolo domainConfigurationName parametro e restituisce i dettagli della configurazione specificata.

Esempio

Aggiornamento delle configurazioni del dominio

Per aggiornare lo stato o l'autorizzatore personalizzato della configurazione del tuo dominio, usa il UpdateDomainConfigurationAPI. Solo l'utente può impostare lo stato su ENABLED o DISABLED. Se si disattiva la configurazione del dominio, i dispositivi connessi a tale dominio ricevono un errore di autenticazione. Attualmente non è possibile aggiornare il certificato del server nella configurazione del dominio. Per modificare il certificato di una configurazione di dominio, è necessario eliminarlo e ricrearlo.

Esempio

Eliminazione delle configurazioni di dominio

Prima di eliminare una configurazione di dominio, utilizza UpdateDomainConfigurationAPIper impostare lo stato su. DISABLED In questo modo è possibile evitare di eliminare accidentalmente l'endpoint. Dopo aver disabilitato la configurazione del dominio, eliminala utilizzando il DeleteDomainConfigurationAPI. È necessario impostare DISABLED lo stato AWS-managed domain per 7 giorni prima di poterli eliminare. Puoi impostare lo DISABLED stato dei domini personalizzati e quindi eliminarli contemporaneamente.

Esempio

Dopo aver eliminato una configurazione di dominio, AWS IoT Core non viene più utilizzato il certificato del server associato a quel dominio personalizzato.

Rotazione di certificati in domini personalizzati

Potrebbe essere necessario sostituire periodicamente il certificato del server con un certificato aggiornato. La tariffa con cui esegui questa operazione dipende dal periodo di validità del certificato. Se hai generato il certificato del server utilizzando AWS Certificate Manager (ACM), puoi impostare il rinnovo automatico del certificato. Quando ACM rinnova il certificato, ritira AWS IoT Core automaticamente il nuovo certificato. Non hai bisogno di eseguire alcuna operazione aggiuntiva. Se hai importato il certificato del server da una fonte diversa, puoi ruotarlo reimportandolo in. ACM Per informazioni sulla reimportazione dei certificati, consulta Reimport a certificate (Reimportazione di un certificato).

Nota

AWS IoT Core raccoglie gli aggiornamenti dei certificati solo nelle seguenti condizioni.

  • Il nuovo certificato è ARN uguale a quello precedente.

  • Il nuovo certificato ha lo stesso algoritmo di firma, nome comune o nome alternativo soggetto di quello precedente.