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

# CreateCluster
<a name="API_elastic_CreateCluster"></a>

Crea un nuovo cluster elastico Amazon DocumentDB e ne restituisce la struttura del cluster.

## Sintassi della richiesta
<a name="API_elastic_CreateCluster_RequestSyntax"></a>

```
POST /cluster HTTP/1.1
Content-type: application/json

{
   "adminUserName": "string",
   "adminUserPassword": "string",
   "authType": "string",
   "backupRetentionPeriod": number,
   "clientToken": "string",
   "clusterName": "string",
   "kmsKeyId": "string",
   "preferredBackupWindow": "string",
   "preferredMaintenanceWindow": "string",
   "shardCapacity": number,
   "shardCount": number,
   "shardInstanceCount": number,
   "subnetIds": [ "string" ],
   "tags": { 
      "string" : "string" 
   },
   "vpcSecurityGroupIds": [ "string" ]
}
```

## Parametri della richiesta URI:
<a name="API_elastic_CreateCluster_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_elastic_CreateCluster_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [adminUserName](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-adminUserName"></a>
Il nome dell'amministratore dei cluster elastici di Amazon DocumentDB.  
 *Vincoli*:  
+ Deve contenere da 1 a 63 lettere o numeri.
+ Il primo carattere deve essere una lettera.
+ Non può essere una parola riservata.
Tipo: stringa  
Obbligatorio: sì

 ** [adminUserPassword](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-adminUserPassword"></a>
La password per l'amministratore dei cluster elastici di Amazon DocumentDB. La password può contenere qualsiasi carattere ASCII stampabile.  
 *Vincoli*:  
+ Deve contenere da 8 a 100 caratteri.
+ Non può contenere una barra (/), virgolette doppie («) o il simbolo «at» (@).
Tipo: stringa  
Obbligatorio: sì

 ** [authType](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-authType"></a>
Il tipo di autenticazione utilizzato per determinare dove recuperare la password utilizzata per accedere al cluster elastico. I tipi validi sono `PLAIN_TEXT` o`SECRET_ARN`.  
Tipo: String  
Valori validi: `PLAIN_TEXT | SECRET_ARN`   
Obbligatorio: sì

 ** [clusterName](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-clusterName"></a>
Il nome del nuovo cluster elastico. Questo parametro è archiviato come stringa in minuscolo.  
 *Vincoli*:  
+ Deve contenere da 1 a 63 lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
 *Esempio*: `my-cluster`   
Tipo: stringa  
Obbligatorio: sì

 ** [shardCapacity](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-shardCapacity"></a>
Il numero di v CPUs assegnato a ciascun frammento di cluster elastico. Il massimo è 64. I valori consentiti sono 2, 4, 8, 16, 32, 64.  
Tipo: numero intero  
Obbligatorio: sì

 ** [shardCount](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-shardCount"></a>
Il numero di shard assegnati al cluster elastico. Il massimo è 32.  
Tipo: numero intero  
Obbligatorio: sì

 ** [backupRetentionPeriod](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-backupRetentionPeriod"></a>
Il numero di giorni per i quali vengono conservate le istantanee automatiche.  
Tipo: Integer  
Obbligatorio: no

 ** [clientToken](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-clientToken"></a>
Il token client per il cluster elastico.  
▬Tipo: stringa  
Obbligatorio: no

 ** [kmsKeyId](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-kmsKeyId"></a>
L'identificatore della chiave KMS da utilizzare per crittografare il nuovo cluster elastico.  
L'identificatore della chiave KMS è l'Amazon Resource Name (ARN) per la chiave di crittografia KMS. Se stai creando un cluster utilizzando lo stesso account Amazon che possiede questa chiave di crittografia KMS, puoi utilizzare l'alias della chiave KMS anziché l'ARN come chiave di crittografia KMS.  
Se non viene specificata una chiave di crittografia, Amazon DocumentDB utilizza la chiave di crittografia predefinita creata da KMS per l'account. Il tuo account ha una chiave di crittografia predefinita diversa per ogni regione Amazon.  
▬Tipo: stringa  
Obbligatorio: no

 ** [preferredBackupWindow](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-preferredBackupWindow"></a>
L'intervallo di tempo giornaliero durante il quale vengono creati i backup automatici, se i backup automatici sono abilitati, come determinato da. `backupRetentionPeriod`  
▬Tipo: stringa  
Obbligatorio: no

 ** [preferredMaintenanceWindow](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-preferredMaintenanceWindow"></a>
Intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.  
 *Format*: `ddd:hh24:mi-ddd:hh24:mi`   
 *Impostazione predefinita*: una finestra di 30 minuti selezionata a caso da un intervallo di tempo di 8 ore per ciascuna Regione AWS, che si verifica in un giorno casuale della settimana.  
 *Giorni validi*: lun, mar, mer, gio, ven, sab, dom  
 *Vincoli*: finestra di un minimo di 30 minuti.  
▬Tipo: stringa  
Obbligatorio: no

 ** [shardInstanceCount](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-shardInstanceCount"></a>
Il numero di istanze di replica che si applicano a tutti gli shard del cluster elastico. `shardInstanceCount`Il valore 1 indica che esiste un'istanza di writer e tutte le istanze aggiuntive sono repliche che possono essere utilizzate per le letture e per migliorare la disponibilità.  
Tipo: Integer  
Obbligatorio: no

 ** [subnetIds](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-subnetIds"></a>
La sottorete Amazon EC2 IDs per il nuovo cluster elastico.  
Tipo: array di stringhe  
Obbligatorio: no

 ** [tags](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-tags"></a>
I tag da assegnare al nuovo cluster elastico.  
Tipo: mappatura stringa a stringa  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Modello di chiave:`(?!aws:)[a-zA-Z+-=._:/]+`   
Vincoli di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Obbligatorio: no

 ** [vpcSecurityGroupIds](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-vpcSecurityGroupIds"></a>
Un elenco di gruppi di sicurezza VPC EC2 da associare al nuovo cluster elastico.  
Tipo: array di stringhe  
Obbligatorio: no

## Sintassi della risposta
<a name="API_elastic_CreateCluster_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

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

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [cluster](#API_elastic_CreateCluster_ResponseSyntax) **   <a name="documentdb-elastic_CreateCluster-response-cluster"></a>
Il nuovo cluster elastico che è stato creato.  
Tipo: oggetto [Cluster](API_elastic_Cluster.md)

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

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

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** ConflictException **   
C'è stato un conflitto di accesso.    
 ** resourceId **   
L'ID della risorsa in cui si è verificato un conflitto di accesso.  
 ** resourceType **   
Il tipo di risorsa in cui si è verificato un conflitto di accesso.
Codice di stato HTTP: 409

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ServiceQuotaExceededException **   
La quota di servizio per l'azione è stata superata.  
Codice di stato HTTP: 402

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta viene rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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