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à.
CreateDBInstance
Crea una nuova istanza.
Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
- DBClusterIdentifier
-
Identificatore del cluster a cui apparterrà l'istanza.
Tipo: stringa
Campo obbligatorio: sì
- DBInstanceClass
-
La capacità di calcolo e di memoria dell'istanza, ad esempio
db.r5.large.Tipo: stringa
Campo obbligatorio: sì
- DBInstanceIdentifier
-
L'identificatore delle istanze. 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:
mydbinstanceTipo: stringa
Campo obbligatorio: sì
-
- Engine
-
Nome del motore di database da utilizzare per questa istanza.
Valore valido:
docdbTipo: stringa
Campo obbligatorio: sì
- AutoMinorVersionUpgrade
-
Questo parametro non si applica ad Amazon DocumentDB. Amazon DocumentDB non esegue aggiornamenti di versione secondari indipendentemente dal valore impostato.
Impostazione predefinita:
falseTipo: Booleano
Campo obbligatorio: no
- AvailabilityZone
-
Zona di disponibilità Amazon EC2 in cui viene creata l'istanza.
Predefinita: una zona di disponibilità scelta casualmente dal sistema nell'endpoint. Regione AWS
Esempio:
us-east-1d▬Tipo: stringa
Campo obbligatorio: no
- CACertificateIdentifier
-
L'identificatore del certificato CA da utilizzare per il certificato del server dell'istanza DB.
Per ulteriori informazioni, consulta Updating your Amazon DocumentDB TLS Certificates and Encrypting Data in Transit nella Amazon DocumentDB Developer Guide.
▬Tipo: stringa
Campo obbligatorio: no
- CopyTagsToSnapshot
-
Un valore che indica se copiare i tag dall'istanza database sugli snapshot dell'istanza database. Per impostazione predefinita i tag non vengono copiati.
Tipo: Booleano
Campo obbligatorio: no
- EnablePerformanceInsights
-
Un valore che indica se abilitare Performance Insights per l'istanza del database. Per ulteriori informazioni, consulta la sezione Utilizzo di Amazon Performance Insights.
Tipo: Booleano
Campo obbligatorio: no
- PerformanceInsightsKMSKeyId
-
L'identificatore AWS KMS chiave per la crittografia dei dati di Performance Insights.
L'identificatore della AWS KMS chiave è l'ARN della chiave, l'ID della chiave, l'alias ARN o il nome alias per la chiave KMS.
Se non specifichi un valore per PerformanceInsights KMSKeyId, Amazon DocumentDB utilizza la tua chiave KMS predefinita. 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
Campo obbligatorio: no
- PreferredMaintenanceWindow
-
Intervallo di tempo settimanale durante il quale può venire eseguita la manutenzione del sistema, nel fuso orario UTC (Universal Coordinated Time).
Formato:
ddd:hh24:mi-ddd:hh24:miL'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
Campo obbligatorio: no
- PromotionTier
-
Un valore che specifica l'ordine in cui una replica di Amazon DocumentDB viene promossa all'istanza principale dopo un errore dell'istanza primaria esistente.
Impostazione predefinita: 1
Valori validi: 0-15
Tipo: integer
Campo obbligatorio: no
- Tag.Tag.N
-
I tag da assegnare all'istanza. Puoi assegnare fino a 10 tag a un'istanza.
Tipo: matrice di oggetti Tag
Campo obbligatorio: no
Elementi di risposta
Il seguente elemento viene restituito dal servizio.
- DBInstance
-
Informazioni dettagliate su un'istanza.
Tipo: oggetto DBInstance
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- AuthorizationNotFound
-
L'IP CIDR o il gruppo di sicurezza Amazon EC2 specificato non sono autorizzati per il gruppo di sicurezza specificato.
Amazon DocumentDB potrebbe inoltre non essere autorizzato a eseguire le azioni necessarie per tuo conto utilizzando IAM.
Codice di stato HTTP: 404
- DBClusterNotFoundFault
-
DBClusterIdentifiernon fa riferimento a un cluster esistente.Codice di stato HTTP: 404
- DBInstanceAlreadyExists
-
Hai già un'istanza con l'identificatore specificato.
Codice di stato HTTP: 400
- DBParameterGroupNotFound
-
DBParameterGroupNamenon fa riferimento a un gruppo di parametri esistente.Codice di stato HTTP: 404
- DBSecurityGroupNotFound
-
DBSecurityGroupNamenon fa riferimento a un gruppo di sicurezza 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
-
DBSubnetGroupNamenon fa riferimento a un gruppo di sottoreti esistente.Codice di stato HTTP: 404
- InstanceQuotaExceeded
-
La richiesta comporterebbe il superamento del numero consentito di istanze.
Codice di stato HTTP: 400
- InsufficientDBInstanceCapacity
-
La classe di istanza specificata non è disponibile nella zona di disponibilità specificata.
Codice di stato HTTP: 400
- InvalidDBClusterStateFault
-
Il cluster non è in uno stato valido.
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
- StorageQuotaExceeded
-
La richiesta comporterebbe il superamento della quantità di spazio di archiviazione consentita disponibile in tutte le istanze.
Codice di stato HTTP: 400
- StorageTypeNotSupported
-
L'archiviazione dello spazio specificato non
StorageTypepuò essere associata all'istanza DB.Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
