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à.
# CreateDBCluster
Crea un nuovo cluster Amazon DocumentDB.
## Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).
** DBClusterIdentifier **
Identificatore del cluster. 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.
Ad esempio: `my-cluster`
Tipo: stringa
Obbligatorio: sì
** Engine **
Il nome del motore di database da utilizzare per questo cluster.
Valori validi: `docdb`
Tipo: stringa
Obbligatorio: sì
**AvailabilityZones. AvailabilityZone**N.
Elenco delle zone di disponibilità Amazon EC2 in cui possono essere create istanze nel cluster.
Tipo: array di stringhe
Obbligatorio: no
** BackupRetentionPeriod **
Il numero di giorni durante i quali vengono conservati i backup automatici. È necessario specificare un valore minimo pari a 1.
Impostazione predefinita: 1
Vincoli:
+ Il valore deve essere compreso tra 1 e 35.
Tipo: Integer
Obbligatorio: no
** DBClusterParameterGroupName **
Il nome del gruppo di parametri del cluster da associare a questo cluster.
▬Tipo: stringa
Obbligatorio: no
** DBSubnetGroupName **
Gruppo di sottoreti da associare a questo cluster.
Vincoli: deve corrispondere al nome di un oggetto `DBSubnetGroup` esistente. Non deve essere predefinito.
Ad esempio: `mySubnetgroup`
▬Tipo: stringa
Obbligatorio: no
** DeletionProtection **
Speciifica se questo cluster può essere eliminato. Se `DeletionProtection` è abilitato, il cluster non può essere eliminato a meno che non venga modificato e `DeletionProtection` disabilitato. `DeletionProtection`protegge i cluster dall'eliminazione accidentale.
Tipo: Booleano
Obbligatorio: no
**EnableCloudwatchLogsExports.Member.**
Un elenco di tipi di log che devono essere abilitati per l'esportazione in Amazon CloudWatch Logs. È possibile abilitare i log di audit o i log del profiler. Per ulteriori informazioni, consulta [Auditing Amazon DocumentDB Events e Profiling Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/event-auditing.html) [Operations](https://docs.aws.amazon.com/documentdb/latest/developerguide/profiling.html).
Tipo: array di stringhe
Obbligatorio: no
** EngineVersion **
Numero di versione del motore di database da utilizzare. Per impostazione predefinita, `--engine-version` sarà l'ultima versione principale del motore. Per i carichi di lavoro di produzione, è consigliabile dichiarare esplicitamente questo parametro con la versione principale del motore prevista.
▬Tipo: stringa
Obbligatorio: no
** GlobalClusterIdentifier **
L'identificatore 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: no
** KmsKeyId **
L'identificatore della AWS KMS chiave per un cluster crittografato.
L'identificatore della AWS KMS chiave è Amazon Resource Name (ARN) per AWS KMS la chiave di crittografia. Se si crea un cluster utilizzando Account AWS lo stesso proprietario della chiave di AWS KMS crittografia utilizzata per crittografare il nuovo cluster, è possibile utilizzare l'alias della AWS KMS chiave anziché l'ARN per la chiave di crittografia. AWS KMS
Se non è specificata una chiave di crittografia in `KmsKeyId`:
+ Se il parametro `StorageEncrypted` è `true`, Amazon DocumentDB utilizza la chiave di crittografia predefinita.
AWS KMS crea la chiave di crittografia predefinita per il tuo. Account AWS La tua Account AWS ha una chiave di crittografia predefinita diversa per ciascuna Regioni AWS.
▬Tipo: stringa
Obbligatorio: no
** ManageMasterUserPassword **
Speciifica se gestire la password dell'utente principale con Amazon Web Services Secrets Manager.
Vincolo: non è possibile gestire la password dell'utente principale con Amazon Web Services Secrets Manager, se specificata`MasterUserPassword`.
Tipo: Booleano
Obbligatorio: no
** MasterUsername **
Nome dell'utente master per il cluster.
Vincoli:
+ Deve contenere da 1 a 63 lettere o numeri.
+ Il primo carattere deve essere una lettera.
+ Non può essere una parola riservata per il motore di database scelto.
▬Tipo: stringa
Obbligatorio: no
** MasterUserPassword **
La password per l'utente del database master. Questa password può contenere qualsiasi carattere ASCII stampabile, eccetto la barra (/), le virgolette (") o il simbolo chiocciola (@).
Vincoli: deve contenere da 8 a 100 caratteri.
▬Tipo: stringa
Obbligatorio: no
** MasterUserSecretKmsKeyId **
L'identificatore della chiave KMS di Amazon Web Services per crittografare un segreto che viene generato e gestito automaticamente in Amazon Web Services Secrets Manager. Questa impostazione è valida solo se la password dell'utente principale è gestita da Amazon DocumentDB in Amazon Web Services Secrets Manager per il cluster DB.
L'identificatore della chiave KMS di Amazon Web Services è l'ARN della chiave, l'ID della chiave, l'alias ARN o il nome alias per la chiave KMS. Per utilizzare una chiave KMS in un altro account Amazon Web Services, specifica la chiave ARN o l'alias ARN.
Se non lo specifichi`MasterUserSecretKmsKeyId`, la chiave `aws/secretsmanager` KMS viene utilizzata per crittografare il segreto. Se il segreto si trova in un altro account Amazon Web Services, non puoi utilizzare la chiave `aws/secretsmanager` KMS per crittografare il segreto e devi utilizzare una chiave KMS gestita dal cliente.
Esiste una chiave KMS predefinita per il tuo account Amazon Web Services. Il tuo account Amazon Web Services ha una chiave KMS predefinita diversa per ogni regione Amazon Web Services.
▬Tipo: stringa
Obbligatorio: no
** NetworkType **
Il tipo di rete del cluster.
Il tipo di rete è determinato da quello `DBSubnetGroup` specificato per il cluster. A `DBSubnetGroup` può supportare solo il IPv4 protocollo o i IPv4 e i IPv6 protocolli (`DUAL`).
Per ulteriori informazioni, consulta [DocumentDB clusters in a VPC nella](https://docs.aws.amazon.com/documentdb/latest/developerguide/vpc-clusters.html) Amazon DocumentDB Developer Guide.
Valori validi: `IPV4` \$1 `DUAL`
▬Tipo: stringa
Obbligatorio: no
** Port **
Il numero di porta su cui le istanze del cluster accettano connessioni.
Tipo: Integer
Obbligatorio: no
** PreferredBackupWindow **
Intervallo di tempo giornaliero durante il quale vengono creati i backup automatici se sono abilitati tramite il parametro `BackupRetentionPeriod`.
L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un intervallo di tempo di 8 ore per ciascuna. Regione AWS
Vincoli:
+ Il valore deve essere nel formato `hh24:mi-hh24:mi`.
+ Il valore deve essere nel fuso orario UTC (Universal Coordinated Time).
+ Il valore non deve essere in conflitto con la finestra di manutenzione preferita.
+ Il valore deve essere almeno di 30 minuti.
▬Tipo: stringa
Obbligatorio: no
** PreferredMaintenanceWindow **
Intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.
Formato: `ddd:hh24:mi-ddd:hh24:mi`
L'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: lunedì, martedì, mercoledì, giovedì, venerdì, sabato, domenica
Vincoli: finestra di un minimo di 30 minuti.
▬Tipo: stringa
Obbligatorio: no
** PreSignedUrl **
Attualmente non è supportato.
▬Tipo: stringa
Obbligatorio: no
** ServerlessV2ScalingConfiguration **
Contiene la configurazione di scalabilità di un cluster Amazon DocumentDB Serverless.
Tipo: oggetto [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md)
Obbligatorio: no
** StorageEncrypted **
Specifica se il cluster è crittografato.
Tipo: Booleano
Obbligatorio: no
** StorageType **
Il tipo di archiviazione da associare al cluster di database.
*Per informazioni sui tipi di storage per i cluster Amazon DocumentDB, consulta le configurazioni di storage dei cluster nella Amazon DocumentDB Developer Guide.*
Valori validi per il tipo di storage - `standard | iopt1`
Il valore predefinito è `standard `
Quando crei un cluster Amazon DocumentDB con il tipo di storage impostato su`iopt1`, il tipo di storage viene restituito nella risposta. Il tipo di storage non viene restituito quando lo imposti `standard` su.
▬Tipo: stringa
Obbligatorio: no
**Tag.Tag.N**
I tag da assegnare al cluster.
Tipo: matrice di oggetti [Tag](API_Tag.md)
Obbligatorio: no
**VpcSecurityGroupIds. VpcSecurityGroupId**N.
Elenco dei gruppi di sicurezza VPC EC2 da associare a questo cluster.
Tipo: array di stringhe
Obbligatorio: no
## Elementi di risposta
Il servizio restituisce il seguente elemento.
** DBCluster **
Informazioni dettagliate su un cluster.
Tipo: oggetto [DBCluster](API_DBCluster.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
** DBClusterAlreadyExistsFault **
Hai già un cluster con l'identificatore fornito.
Codice di stato HTTP: 400
** DBClusterNotFoundFault **
`DBClusterIdentifier`non fa riferimento a un cluster esistente.
Codice di stato HTTP: 404
** DBClusterParameterGroupNotFound **
`DBClusterParameterGroupName`non fa riferimento a un gruppo di parametri del cluster esistente.
Codice di stato HTTP: 404
** DBClusterQuotaExceededFault **
Il cluster non può essere creato perché è stata raggiunta la quota massima consentita di cluster.
Codice di stato HTTP: 403
** DBInstanceNotFound **
`DBInstanceIdentifier`non fa riferimento a un'istanza esistente.
Codice di stato HTTP: 404
** DBSubnetGroupDoesNotCoverEnoughAZs **
Le sottoreti del gruppo di sottoreti devono coprire almeno due zone di disponibilità, a meno che non esista una sola zona di disponibilità.
Codice di stato HTTP: 400
** DBSubnetGroupNotFoundFault **
`DBSubnetGroupName`non fa riferimento a un gruppo di sottoreti esistente.
Codice di stato HTTP: 404
** GlobalClusterNotFoundFault **
`GlobalClusterIdentifier`Non si riferisce a un cluster globale esistente.
Codice di stato HTTP: 404
** InsufficientStorageClusterCapacity **
Lo spazio di archiviazione disponibile non è sufficiente per l'azione corrente. È possibile risolvere questo errore aggiornando il gruppo di sottoreti in modo che utilizzi zone di disponibilità diverse con più spazio di archiviazione disponibile.
Codice di stato HTTP: 400
** 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
** InvalidDBSubnetGroupStateFault **
Il gruppo di sottoreti non può essere eliminato perché è in uso.
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
** InvalidSubnet **
La sottorete richiesta non è valida oppure sono state richieste più sottoreti che non si trovano tutte in un cloud privato virtuale (VPC) comune.
Codice di stato HTTP: 400
** InvalidVPCNetworkStateFault **
Il gruppo di sottoreti non copre tutte le zone di disponibilità dopo la creazione a causa delle modifiche apportate.
Codice di stato HTTP: 400
** KMSKeyNotAccessibleFault **
Si è verificato un errore durante l'accesso a una AWS KMS chiave.
Codice di stato HTTP: 400
** NetworkTypeNotSupported **
Il tipo di rete non è supportato `DBSubnetGroup` né dalla versione del motore DB.
Codice di stato HTTP: 400
** StorageQuotaExceeded **
La richiesta comporterebbe il superamento della quantità di storage consentita disponibile in tutte le istanze.
Codice di stato HTTP: 400
## Vedi anche
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/CreateDBCluster)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBCluster)