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à.

# FailoverGlobalCluster
<a name="API_FailoverGlobalCluster"></a>

Promuove il cluster DB secondario specificato a diventare il cluster DB primario nel cluster globale quando si verifica il failover di un cluster globale.

Utilizzate questa operazione per rispondere a un evento non pianificato, ad esempio un disastro regionale nella regione primaria. Il failover può comportare la perdita dei dati delle transazioni di scrittura che non sono stati replicati sul dispositivo secondario scelto prima che si verificasse l'evento di failover. Tuttavia, il processo di ripristino che promuove un'istanza DB sul cluster DB secondario scelto come istanza DB di scrittura principale garantisce che i dati si trovino in uno stato transazionale coerente.

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

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

 ** GlobalClusterIdentifier **   
L'identificatore del cluster globale Amazon DocumentDB per applicare questa operazione. L'identificatore è la chiave univoca assegnata dall'utente al momento della creazione del cluster. In altre parole, è il nome del cluster globale.  
Vincoli:  
+ Deve corrispondere all'identificatore di un cluster globale 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ì

 ** TargetDbClusterIdentifier **   
L'identificatore del cluster Amazon DocumentDB secondario che desideri promuovere a primario per il cluster 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ì

 ** AllowDataLoss **   
Speciifica se consentire la perdita di dati per questa operazione globale del cluster. Consentire la perdita di dati attiva un'operazione di failover globale.  
Se non si specifica`AllowDataLoss`, per impostazione predefinita l'operazione globale del cluster è uno switchover.  
Vincoli:  
+ Non può essere specificato insieme al parametro. `Switchover`
Tipo: Booleano  
Obbligatorio: no

 ** Switchover **   
Speciifica se passare da un cluster di database globale a un altro.  
Vincoli:  
+ Non può essere specificato insieme al `AllowDataLoss` parametro.
Tipo: Booleano  
Obbligatorio: no

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

Il seguente elemento viene restituito dal servizio.

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

## Errori
<a name="API_FailoverGlobalCluster_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_FailoverGlobalCluster_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/FailoverGlobalCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/FailoverGlobalCluster)