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
<a name="iot-custom-endpoints-managing"></a>

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 segue APIs: [ListDomainConfigurations](https://docs.aws.amazon.com/iot/latest/apireference/API_ListDomainConfigurations.html),, [DescribeDomainConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeDomainConfiguration.html)e. [UpdateDomainConfiguration[DeleteDomainConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteDomainConfiguration.html)](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateDomainConfiguration.html)

**Topics**
+ [Visualizzazione delle configurazioni del dominio](#iot-custom-endpoints-managing-view)
+ [Aggiornamento delle configurazioni del dominio](#iot-custom-endpoints-managing-update)
+ [Eliminazione delle configurazioni di dominio](#iot-custom-endpoints-managing-delete)
+ [Rotazione di certificati in domini personalizzati](#iot-custom-endpoints-managing-certificates)

## Visualizzazione delle configurazioni del dominio
<a name="iot-custom-endpoints-managing-view"></a>

Per restituire un elenco impaginato di tutte le configurazioni di dominio presenti nel tuo, utilizza l'API. Account AWS[ListDomainConfigurations](https://docs.aws.amazon.com/iot/latest/apireference/API_ListDomainConfigurations.html) Puoi visualizzare i dettagli di una particolare configurazione di dominio utilizzando l'API. [DescribeDomainConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeDomainConfiguration.html) Questa API accetta un singolo parametro `domainConfigurationName` e restituisce i dettagli della configurazione specificata.

**Esempio**

## Aggiornamento delle configurazioni del dominio
<a name="iot-custom-endpoints-managing-update"></a>

Per aggiornare lo stato o l'autorizzatore personalizzato della configurazione del tuo dominio, utilizza l'[UpdateDomainConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateDomainConfiguration.html)API. 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
<a name="iot-custom-endpoints-managing-delete"></a>

Prima di eliminare una configurazione di dominio, utilizza l'[UpdateDomainConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateDomainConfiguration.html)API per impostare lo stato su. `DISABLED` In questo modo è possibile evitare di eliminare accidentalmente l'endpoint. Dopo aver disabilitato la configurazione del dominio, eliminala utilizzando l'[DeleteDomainConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteDomainConfiguration.html)API. Devi impostare lo `DISABLED` 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
<a name="iot-custom-endpoints-managing-certificates"></a>

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 il certificato del server è stato generato utilizzando AWS Certificate Manager (ACM), è possibile impostare il certificato per il rinnovo automatico. Quando ACM rinnova il certificato, ritira AWS IoT Core automaticamente il nuovo certificato. Non hai bisogno di eseguire alcuna operazione aggiuntiva. Se il certificato del server è stato importato da un'altra fonte, può essere ruotato reimportandolo in ACM. Per informazioni sulla reimportazione dei certificati, consulta [Reimport a certificate (Reimportazione di un certificato)](https://docs.aws.amazon.com/acm/latest/userguide/import-reimport.html).

**Nota**  
AWS IoT Core raccoglie gli aggiornamenti dei certificati solo nelle seguenti condizioni.  
Il nuovo certificato ha lo stesso ARN di quello precedente.
Il nuovo certificato ha lo stesso algoritmo di firma, nome comune o nome alternativo soggetto di quello precedente.