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.
- 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.
Esempio:
my-cluster
Tipo: stringa
Campo obbligatorio: sì
-
- Engine
-
Il nome del motore di database da utilizzare per questo cluster.
Valori validi:
docdb
Tipo: stringa
Campo obbligatorio: sì
- AvailabilityZones. AvailabilityZoneN.
-
Un elenco di zone di EC2 disponibilità Amazon in cui è possibile creare le istanze del cluster.
Tipo: matrice di stringhe
Campo 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
Campo obbligatorio: no
-
- DBClusterParameterGroupName
-
Il nome del gruppo di parametri del cluster da associare a questo cluster.
Tipo: string
Campo 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.Esempio:
mySubnetgroup
Tipo: string
Campo 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 eDeletionProtection
disabilitato.DeletionProtection
protegge i cluster dall'eliminazione accidentale.Tipo: Booleano
Campo 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 Operations.
Tipo: matrice di stringhe
Campo 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: string
Campo obbligatorio: no
- GlobalClusterIdentifier
-
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
- KmsKeyId
-
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
:-
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: string
Campo 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
Campo 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: string
Campo obbligatorio: no
-
- MasterUserPassword
-
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
- MasterUserSecretKmsKeyId
-
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 specifichi
MasterUserSecretKmsKeyId
, laaws/secretsmanager
KMS chiave viene utilizzata per crittografare il segreto. Se il segreto si trova in un altro account Amazon Web Services, non puoi utilizzare laaws/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
- Port
-
Il numero di porta su cui le istanze del cluster accettano connessioni.
Tipo: integer
Campo 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
. -
Deve essere in Universal Coordinated Time ()UTC.
-
Il valore non deve essere in conflitto con la finestra di manutenzione preferita.
-
Il valore deve essere almeno di 30 minuti.
Tipo: string
Campo obbligatorio: no
-
- PreferredMaintenanceWindow
-
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
- PreSignedUrl
-
Attualmente non è supportato.
Tipo: string
Campo obbligatorio: no
- StorageEncrypted
-
Specifica se il cluster è crittografato.
Tipo: Booleano
Campo 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
Nota
Quando si crea un cluster DocumentDB DB con il tipo di archiviazione impostato su
iopt1
, il tipo di archiviazione viene restituito nella risposta. Il tipo di archiviazione non viene restituito quando lo si imposta su.standard
Tipo: string
Campo obbligatorio: no
- Tag.Tag.N
-
I tag da assegnare al cluster.
Tipo: matrice di oggetti Tag
Campo obbligatorio: no
- VpcSecurityGroupIds. VpcSecurityGroupIdN.
-
Un elenco di gruppi di EC2 VPC sicurezza da associare a questo cluster.
Tipo: matrice di stringhe
Campo obbligatorio: no
Elementi di risposta
Il servizio restituisce il seguente elemento.
- DBCluster
-
Informazioni dettagliate su un cluster.
Tipo: oggetto DBCluster
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- DBClusterAlreadyExistsFault
-
Hai già un cluster con l'identificatore fornito.
HTTPCodice di stato: 400
- DBClusterNotFoundFault
-
DBClusterIdentifier
non si riferisce a un cluster esistente.HTTPCodice di stato: 404
- DBClusterParameterGroupNotFound
-
DBClusterParameterGroupName
non fa riferimento a un gruppo di parametri del cluster esistente.HTTPCodice di stato: 404
- DBClusterQuotaExceededFault
-
Il cluster non può essere creato perché hai raggiunto la quota massima consentita di cluster.
HTTPCodice di stato: 403
- DBInstanceNotFound
-
DBInstanceIdentifier
non si riferisce a un'istanza esistente.HTTPCodice di stato: 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à.
HTTPCodice di stato: 400
- DBSubnetGroupNotFoundFault
-
DBSubnetGroupName
non fa riferimento a un gruppo di sottoreti esistente.HTTPCodice di stato: 404
- GlobalClusterNotFoundFault
-
GlobalClusterIdentifier
Non si riferisce a un cluster globale esistente.HTTPCodice di stato: 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.
HTTPCodice di stato: 400
- InvalidDBClusterStateFault
-
Il cluster non è in uno stato valido.
HTTPCodice di stato: 400
- InvalidDBInstanceState
-
L'istanza specificata non è nello stato disponibile.
HTTPCodice di stato: 400
- InvalidDBSubnetGroupStateFault
-
Il gruppo di sottoreti non può essere eliminato perché è in uso.
HTTPCodice di stato: 400
- InvalidGlobalClusterStateFault
-
L'operazione richiesta non può essere eseguita mentre il cluster si trova in questo stato.
HTTPCodice di stato: 400
- InvalidSubnet
-
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
- InvalidVPCNetworkStateFault
-
Il gruppo di sottoreti non copre tutte le zone di disponibilità dopo la sua creazione a causa delle modifiche apportate.
HTTPCodice di stato: 400
- KMSKeyNotAccessibleFault
-
Si è verificato un errore durante l'accesso a una AWS KMS chiave.
HTTPCodice di stato: 400
- StorageQuotaExceeded
-
La richiesta comporterebbe il superamento della quantità di storage consentita disponibile in tutte le istanze.
HTTPCodice di stato: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: