CreateDBCluster

Identificatore del cluster. Questo parametro è archiviato come stringa in minuscolo.

Vincoli:

Esempio: my-cluster

Tipo: stringa

Campo obbligatorio: sì

Il nome del motore di database da utilizzare per questo cluster.

Valori validi: docdb

Tipo: stringa

Campo obbligatorio: sì

Un elenco di zone di EC2 disponibilità Amazon in cui è possibile creare le istanze del cluster.

Tipo: matrice di stringhe

Campo obbligatorio: no

Il numero di giorni durante i quali vengono conservati i backup automatici. È necessario specificare un valore minimo pari a 1.

Impostazione predefinita: 1

Vincoli:

Tipo: integer

Campo obbligatorio: no

Il nome del gruppo di parametri del cluster da associare a questo cluster.

Tipo: string

Campo obbligatorio: no

Gruppo di sottoreti da associare a questo cluster.

Vincoli: deve corrispondere al nome di un oggetto DBSubnetGroup esistente. Non deve essere predefinito.

Esempio: mySubnetgroup

Tipo: string

Campo obbligatorio: no

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. DeletionProtectionprotegge i cluster dall'eliminazione accidentale.

Tipo: Booleano

Campo obbligatorio: no

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

Tipo: matrice di stringhe

Campo obbligatorio: no

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: string

Campo obbligatorio: no

L'identificatore del nuovo cluster globale.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.

Modello: [A-Za-z][0-9A-Za-z-:._]*

Campo obbligatorio: no

L'identificatore della AWS KMS chiave per un cluster crittografato.

L'identificatore della AWS KMS chiave è Amazon Resource Name (ARN) per la chiave di AWS KMS crittografia. Se stai creando un cluster utilizzando Account AWS lo stesso proprietario della chiave di AWS KMS crittografia utilizzata per crittografare il nuovo cluster, puoi utilizzare l'alias della AWS KMS chiave anziché quello ARN per la AWS KMS chiave di crittografia.

Se non è specificata una chiave di crittografia in KmsKeyId:

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: string

Campo obbligatorio: no

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

Tipo: Booleano

Campo obbligatorio: no

Nome dell'utente master per il cluster.

Vincoli:

Tipo: string

Campo obbligatorio: no

La password per l'utente del database master. Questa password può contenere qualsiasi ASCII carattere stampabile tranne la barra (/), le virgolette doppie («) o il simbolo «at» (@).

Vincoli: deve contenere da 8 a 100 caratteri.

Tipo: string

Campo obbligatorio: no

L'identificatore KMS chiave 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 KMS chiave di Amazon Web Services è la chiaveARN, l'ID chiave, l'alias ARN o il nome alias della chiave. KMS Per utilizzare una KMS chiave in un altro account Amazon Web Services, specifica la chiave ARN o l'aliasARN.

Se non lo specifichiMasterUserSecretKmsKeyId, la aws/secretsmanager KMS chiave viene utilizzata per crittografare il segreto. Se il segreto si trova in un altro account Amazon Web Services, non puoi utilizzare la aws/secretsmanager KMS chiave per crittografare il segreto e devi utilizzare una KMS chiave gestita dal cliente.

Esiste una KMS chiave predefinita per il tuo account Amazon Web Services. Il tuo account Amazon Web Services ha una KMS chiave predefinita diversa per ogni regione Amazon Web Services.

Tipo: string

Campo obbligatorio: no

Il numero di porta su cui le istanze del cluster accettano connessioni.

Tipo: integer

Campo obbligatorio: no

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:

Tipo: string

Campo obbligatorio: no

L'intervallo di tempo settimanale durante il quale può avvenire la manutenzione del sistema, in Universal Coordinated Time (UTC).

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: string

Campo obbligatorio: no

Attualmente non è supportato.

Tipo: string

Campo obbligatorio: no

Specifica se il cluster è crittografato.

Tipo: Booleano

Campo obbligatorio: no

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

Tipo: string

Campo obbligatorio: no

I tag da assegnare al cluster.

Tipo: matrice di oggetti Tag

Campo obbligatorio: no

Un elenco di gruppi di EC2 VPC sicurezza da associare a questo cluster.

Tipo: matrice di stringhe

Campo obbligatorio: no

Informazioni dettagliate su un cluster.

Tipo: oggetto DBCluster

Hai già un cluster con l'identificatore fornito.

HTTPCodice di stato: 400

DBClusterIdentifiernon si riferisce a un cluster esistente.

HTTPCodice di stato: 404

DBClusterParameterGroupNamenon fa riferimento a un gruppo di parametri del cluster esistente.

HTTPCodice di stato: 404

Il cluster non può essere creato perché hai raggiunto la quota massima consentita di cluster.

HTTPCodice di stato: 403

DBInstanceIdentifiernon si riferisce a un'istanza esistente.

HTTPCodice di stato: 404

Le sottoreti del gruppo di sottoreti devono coprire almeno due zone di disponibilità, a meno che non esista una sola zona di disponibilità.

HTTPCodice di stato: 400

DBSubnetGroupNamenon fa riferimento a un gruppo di sottoreti esistente.

HTTPCodice di stato: 404

GlobalClusterIdentifierNon si riferisce a un cluster globale esistente.

HTTPCodice di stato: 404

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.

HTTPCodice di stato: 400

Il cluster non è in uno stato valido.

HTTPCodice di stato: 400

L'istanza specificata non è nello stato disponibile.

HTTPCodice di stato: 400

Il gruppo di sottoreti non può essere eliminato perché è in uso.

HTTPCodice di stato: 400

L'operazione richiesta non può essere eseguita mentre il cluster si trova in questo stato.

HTTPCodice di stato: 400

La sottorete richiesta non è valida oppure sono state richieste più sottoreti che non si trovano tutte in un cloud privato virtuale comune (). VPC

HTTPCodice di stato: 400

Il gruppo di sottoreti non copre tutte le zone di disponibilità dopo la sua creazione a causa delle modifiche apportate.

HTTPCodice di stato: 400

Si è verificato un errore durante l'accesso a una AWS KMS chiave.

HTTPCodice di stato: 400

La richiesta comporterebbe il superamento della quantità di storage consentita disponibile in tutte le istanze.

HTTPCodice di stato: 400