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
<a name="API_SwitchoverGlobalCluster"></a>

Passa al cluster Amazon DocumentDB secondario specificato per diventare il nuovo cluster Amazon DocumentDB primario nel cluster di database globale.

## Parametri della richiesta
<a name="API_SwitchoverGlobalCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** 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: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
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: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: sì

## Elementi di risposta
<a name="API_SwitchoverGlobalCluster_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** GlobalCluster **   
Un tipo di dati che rappresenta un cluster globale Amazon DocumentDB.  
Tipo: oggetto [GlobalCluster](API_GlobalCluster.md)

## Errori
<a name="API_SwitchoverGlobalCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** 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
<a name="API_SwitchoverGlobalCluster_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/SwitchoverGlobalCluster)