SwitchoverGlobalCluster - Amazon DocumentDB

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

DBClusterIdentifiernon si riferisce a un cluster esistente.

Codice di stato HTTP: 404

GlobalClusterNotFoundFault

GlobalClusterIdentifierNon 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: