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à.
SwitchoverGlobalCluster
Passa al cluster Amazon DocumentDB secondario specificato per diventare il nuovo cluster Amazon DocumentDB primario nel cluster di database globale.
Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
- GlobalClusterIdentifier
-
L'identificatore del cluster di database globale Amazon DocumentDB su cui passare. L'identificatore è la chiave univoca assegnata dall'utente al momento della creazione del cluster. In altre parole, è il nome del cluster globale. Questo parametro non fa distinzione tra maiuscole e minuscole.
Vincoli:
-
Deve corrispondere all'identificatore di un cluster globale esistente (database globale Amazon DocumentDB).
-
Lunghezza minima pari a 1. Lunghezza massima di 255.
Modello:
[A-Za-z][0-9A-Za-z-:._]*
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.
Modello:
[A-Za-z][0-9A-Za-z-:._]*
Campo obbligatorio: sì
-
- TargetDbClusterIdentifier
-
L'identificatore del cluster Amazon DocumentDB secondario da promuovere al nuovo cluster primario per il cluster di database globale. Utilizza Amazon Resource Name (ARN) come identificatore in modo che Amazon DocumentDB possa localizzare il cluster nella sua regione. AWS
Vincoli:
-
Deve corrispondere all'identificatore di un cluster secondario esistente.
-
Lunghezza minima pari a 1. Lunghezza massima di 255.
Modello:
[A-Za-z][0-9A-Za-z-:._]*
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.
Modello:
[A-Za-z][0-9A-Za-z-:._]*
Campo obbligatorio: sì
-
Elementi di risposta
Il servizio restituisce il seguente elemento.
- GlobalCluster
-
Un tipo di dati che rappresenta un cluster globale Amazon DocumentDB.
Tipo: oggetto GlobalCluster
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- DBClusterNotFoundFault
-
DBClusterIdentifier
non si riferisce a un cluster esistente.Codice di stato HTTP: 404
- GlobalClusterNotFoundFault
-
GlobalClusterIdentifier
Non si riferisce a un cluster globale esistente.Codice di stato HTTP: 404
- InvalidDBClusterStateFault
-
Il cluster non è in uno stato valido.
Codice di stato HTTP: 400
- InvalidGlobalClusterStateFault
-
L'operazione richiesta non può essere eseguita mentre il cluster si trova in questo stato.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: