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à.
FailoverDBCluster
Impone un failover per un cluster.
Un failover per un cluster promuove una delle repliche di Amazon DocumentDB (istanze di sola lettura) nel cluster come istanza principale (lo scrittore del cluster).
In caso di errore dell'istanza primaria, Amazon DocumentDB esegue automaticamente il failover su una replica di Amazon DocumentDB, se esistente. Puoi forzare un failover per simulare un guasto di un'istanza primaria per scopi di testing.
Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
- DBClusterIdentifier
-
Un identificatore di cluster per cui forzare un failover. Questo parametro non distingue tra maiuscole e minuscole.
Vincoli:
-
Deve corrispondere all'identificativo di un
DBClusteresistente.
▬Tipo: stringa
Campo obbligatorio: no
-
- TargetDBInstanceIdentifier
-
Nome dell'istanza da promuovere a istanza primaria.
È necessario specificare l'identificatore di istanza per una replica di Amazon DocumentDB nel cluster. Ad esempio,
mydbcluster-replica1.▬Tipo: stringa
Campo obbligatorio: no
Elementi di risposta
Il seguente elemento viene restituito dal servizio.
- DBCluster
-
Informazioni dettagliate su un cluster.
Tipo: oggetto DBCluster
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- DBClusterNotFoundFault
-
DBClusterIdentifiernon si riferisce a un cluster esistente.Codice di stato HTTP: 404
- InvalidDBClusterStateFault
-
Il cluster non è in uno stato valido.
Codice di stato HTTP: 400
- InvalidDBInstanceState
-
L'istanza specificata non è nello stato disponibile.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
