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

# CreateGlobalCluster
<a name="API_CreateGlobalCluster"></a>

Crea un cluster globale Amazon DocumentDB che può estendersi su più di un cluster. Regioni AWS Il cluster globale contiene un cluster primario con funzionalità di lettura/scrittura e fino a 10 cluster secondari di sola lettura. I cluster globali utilizzano la replica rapida basata sullo storage tra regioni con latenze inferiori a un secondo, utilizzando un'infrastruttura dedicata senza alcun impatto sulle prestazioni del carico di lavoro.



È possibile creare un cluster globale inizialmente vuoto e quindi aggiungervi un cluster primario e uno secondario. In alternativa, è possibile specificare un cluster esistente durante l'operazione di creazione e questo cluster diventa il cluster principale del cluster globale. 

**Nota**  
Questa azione si applica solo ai cluster Amazon DocumentDB.

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

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

 ** GlobalClusterIdentifier **   
L'identificatore del cluster del nuovo cluster globale.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: sì

 ** DatabaseName **   
Nome per il database, composto da un massimo di 64 caratteri alfanumerici. Se non fornisci un nome, Amazon DocumentDB non creerà un database nel cluster globale che stai creando.  
▬Tipo: stringa  
Obbligatorio: no

 ** DeletionProtection **   
L'impostazione di protezione dall'eliminazione per il nuovo cluster globale. Il cluster globale non può essere eliminato quando è abilitata la protezione dall'eliminazione.   
Tipo: Booleano  
Obbligatorio: no

 ** Engine **   
Il nome del motore di database da utilizzare per questo cluster.  
▬Tipo: stringa  
Obbligatorio: no

 ** EngineVersion **   
La versione del motore del cluster globale.  
▬Tipo: stringa  
Obbligatorio: no

 ** SourceDBClusterIdentifier **   
L'Amazon Resource Name (ARN) da utilizzare come cluster primario del cluster globale. Questo parametro è facoltativo.  
▬Tipo: stringa  
Obbligatorio: no

 ** StorageEncrypted **   
L'impostazione di crittografia dello storage per il nuovo cluster globale.   
Tipo: Booleano  
Obbligatorio: no

## Elementi di risposta
<a name="API_CreateGlobalCluster_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_CreateGlobalCluster_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

 ** GlobalClusterAlreadyExistsFault **   
`GlobalClusterIdentifier` esiste già. Scegli un nuovo identificatore globale del cluster (nome univoco) per creare un nuovo cluster globale.   
Codice di stato HTTP: 400

 ** GlobalClusterQuotaExceededFault **   
Il numero di cluster globali per questo account è già al massimo consentito.  
Codice di stato HTTP: 400

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

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