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à.
ModifyDBInstance
Modifica le impostazioni per un'istanza. Puoi modificare uno o più parametri di configurazione del database specificando questi parametri e i nuovi valori nella richiesta.
Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
- DBInstanceIdentifier
-
L'identificatore delle istanze. Questo valore è archiviato come stringa in caratteri minuscoli.
Vincoli:
-
Deve corrispondere all'identificativo di un
DBInstanceesistente.
Tipo: stringa
Campo obbligatorio: sì
-
- ApplyImmediately
-
Speciifica se le modifiche in questa richiesta e tutte le modifiche in sospeso vengono applicate in modo asincrono il prima possibile, indipendentemente dall'impostazione per l'istanza.
PreferredMaintenanceWindowSe questo parametro è impostato su
false, le modifiche all'istanza vengono applicate durante la finestra di manutenzione successiva. Alcune modifiche ai parametri possono causare un'interruzione e vengono applicate al riavvio successivo.Impostazione predefinita:
falseTipo: Booleano
Campo obbligatorio: no
- AutoMinorVersionUpgrade
-
Questo parametro non si applica ad Amazon DocumentDB. Amazon DocumentDB non esegue aggiornamenti di versione secondari indipendentemente dal valore impostato.
Tipo: Booleano
Campo obbligatorio: no
- CACertificateIdentifier
-
Indica il certificato che deve essere associato all'istanza.
▬Tipo: stringa
Campo obbligatorio: no
- CertificateRotationRestart
-
Speciifica se l'istanza DB viene riavviata quando si ruota il certificato. SSL/TLS
Per impostazione predefinita, l'istanza DB viene riavviata quando si ruota il certificato. SSL/TLS Il certificato non viene aggiornato finché l'istanza DB non viene riavviata.
Importante
Imposta questo parametro solo se non lo utilizzi SSL/TLS per connetterti all'istanza DB.
Se lo utilizzi SSL/TLS per connetterti all'istanza DB, consulta Updating Your Amazon DocumentDB TLS Certificates and Encrypting Data in Transit nella Amazon DocumentDB Developer Guide.
Tipo: Booleano
Campo obbligatorio: no
- CopyTagsToSnapshot
-
Un valore che indica se copiare tutti i tag dall'istanza DB negli snapshot dell'istanza DB. Per impostazione predefinita i tag non vengono copiati.
Tipo: Booleano
Campo obbligatorio: no
- DBInstanceClass
-
La nuova capacità di calcolo e memoria dell'istanza, ad esempio.
db.r5.largeNon tutte le classi di istanze sono disponibili in tutte Regioni AWS.Se si modifica la classe dell'istanza, si verifica un'interruzione durante la modifica. La modifica viene applicata durante la finestra di manutenzione successiva, a meno che il valore di
ApplyImmediatelyper questa richiesta non siatrue.Predefinito: utilizza l'impostazione esistente.
▬Tipo: stringa
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
- NewDBInstanceIdentifier
-
Il nuovo identificatore di istanza per l'istanza quando si rinomina un'istanza. Quando si modifica l'identificatore dell'istanza, si verifica immediatamente un riavvio dell'istanza se si imposta su.
Apply ImmediatelytrueSi verifica durante la finestra di manutenzione successiva, se impostata suApply Immediately.falseQuesto valore è archiviato come stringa in caratteri minuscoli.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:
mydbinstance▬Tipo: stringa
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 KMSKey Id, 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 (nel fuso orario UTC) durante il quale può verificarsi la finestra di manutenzione del sistema, che potrebbe comportare un'interruzione. La modifica di questo parametro non comporta un'interruzione tranne nella situazione seguente e la modifica viene applicata in modo asincrono il prima possibile. Se ci sono azioni in sospeso che causano il riavvio e la finestra di manutenzione viene modificata per includere l'ora corrente, la modifica di questo parametro provoca il riavvio dell'istanza. Se si sposta questa finestra all'ora corrente, devono trascorrere almeno 30 minuti tra l'ora corrente e la fine della finestra per garantire che vengano applicate le modifiche in sospeso.
Predefinito: utilizza l'impostazione esistente.
Formato:
ddd:hh24:mi-ddd:hh24:miGiorni validi: lunedì, martedì, mercoledì, giovedì, venerdì, sabato, domenica
Vincoli: deve durare almeno 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
Elementi di risposta
Il servizio restituisce il seguente elemento.
- 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 EC2 di sicurezza Amazon 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
- CertificateNotFound
-
CertificateIdentifiernon fa riferimento a un certificato esistente.Codice di stato HTTP: 404
- DBInstanceAlreadyExists
-
Hai già un'istanza con l'identificatore specificato.
Codice di stato HTTP: 400
- DBInstanceNotFound
-
DBInstanceIdentifiernon fa riferimento a un'istanza esistente.Codice di stato HTTP: 404
- 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
- DBUpgradeDependencyFailure
-
L'aggiornamento non è riuscito perché una risorsa da cui dipende non può essere modificata.
Codice di stato HTTP: 400
- InsufficientDBInstanceCapacity
-
La classe di istanza specificata non è disponibile nella zona di disponibilità specificata.
Codice di stato HTTP: 400
- InvalidDBInstanceState
-
L'istanza specificata non è nello stato disponibile.
Codice di stato HTTP: 400
- InvalidDBSecurityGroupState
-
Lo stato del gruppo di sicurezza non consente l'eliminazione.
Codice di stato HTTP: 400
- InvalidVPCNetworkStateFault
-
Il gruppo di sottoreti non copre tutte le zone di disponibilità dopo la sua creazione a causa delle modifiche apportate.
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
- 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 una delle lingue specifiche AWS SDKs, consulta quanto segue:
