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

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

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

 ** 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 `DBCluster` esistente.
▬Tipo: stringa  
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  
Obbligatorio: no

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

Il seguente elemento viene restituito dal servizio.

 ** DBCluster **   
Informazioni dettagliate su un cluster.   
Tipo: oggetto [DBCluster](API_DBCluster.md)

## Errori
<a name="API_FailoverDBCluster_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

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