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à.
# ModifyDBCluster
Modifica un'impostazione per un cluster Amazon DocumentDB. 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](CommonParameters.md).
** DBClusterIdentifier **
L'identificatore del cluster per il cluster che viene modificato. Questo parametro non distingue tra maiuscole e minuscole.
Vincoli:
+ Deve corrispondere all'identificativo di un `DBCluster` esistente.
Tipo: stringa
Obbligatorio: sì
** AllowMajorVersionUpgrade **
Un valore che Indica che gli aggiornamenti delle versioni principali sono permessi.
Vincoli:
+ È necessario consentire gli aggiornamenti delle versioni principali quando si specifica un valore per il `EngineVersion` parametro che è una versione principale diversa dalla versione corrente del cluster.
+ Poiché alcuni parametri sono specifici della versione, la loro modifica richiede l'esecuzione di una nuova chiamata `ModifyDBCluster` API dopo il completamento dell'MVU locale.
L'esecuzione di un MVU influisce direttamente sui seguenti parametri:
+ `MasterUserPassword`
+ `NewDBClusterIdentifier`
+ `VpcSecurityGroupIds`
+ `Port`
Tipo: Booleano
Obbligatorio: no
** ApplyImmediately **
Un valore che specifica se le modifiche in questa richiesta e le eventuali modifiche in sospeso vengono applicate in modo asincrono il prima possibile, indipendentemente dall'impostazione per il cluster. `PreferredMaintenanceWindow` Se questo parametro è impostato su`false`, le modifiche al cluster vengono applicate durante la finestra di manutenzione successiva.
Il `ApplyImmediately` parametro influisce solo sui `MasterUserPassword` valori `NewDBClusterIdentifier` and. Se impostate questo valore del parametro su`false`, le modifiche ai `MasterUserPassword` valori `NewDBClusterIdentifier` and vengono applicate durante la finestra di manutenzione successiva. Tutte le altre modifiche vengono applicate immediatamente, indipendentemente dal valore del parametro `ApplyImmediately`.
Impostazione predefinita: `false`
Tipo: Booleano
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
** CloudwatchLogsExportConfiguration **
L'impostazione di configurazione per i tipi di log da abilitare per l'esportazione in Amazon CloudWatch Logs per un'istanza o un cluster specifico. Gli `DisableLogTypes` array `EnableLogTypes` and determinano quali log vengono esportati (o non esportati) in Logs. CloudWatch
Tipo: oggetto [CloudwatchLogsExportConfiguration](API_CloudwatchLogsExportConfiguration.md)
Obbligatorio: no
** DBClusterParameterGroupName **
Il nome del gruppo di parametri del cluster da utilizzare per il cluster.
▬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
** EngineVersion **
Numero di versione del motore di database a cui eseguire l'aggiornamento. La modifica di questo parametro provoca un'interruzione. La modifica viene applicata durante la finestra di manutenzione successiva, a meno che il parametro `ApplyImmediately` non sia abilitato.
Per elencare tutte le versioni del motore disponibili per Amazon DocumentDB, usa il seguente comando:
`aws docdb describe-db-engine-versions --engine docdb --query "DBEngineVersions[].EngineVersion"`
▬Tipo: stringa
Obbligatorio: no
** ManageMasterUserPassword **
Speciifica se gestire la password dell'utente principale con Amazon Web Services Secrets Manager. Se il cluster non gestisce la password dell'utente principale con Amazon Web Services Secrets Manager, puoi attivare questa gestione. In questo caso, non puoi specificare`MasterUserPassword`. Se il cluster gestisce già la password dell'utente principale con Amazon Web Services Secrets Manager e specifichi che la password dell'utente principale non è gestita con Amazon Web Services Secrets Manager, devi specificare`MasterUserPassword`. In questo caso, Amazon DocumentDB elimina il segreto e utilizza la nuova password per l'utente master specificato da. `MasterUserPassword`
Tipo: Booleano
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 sono soddisfatte entrambe le seguenti condizioni:
+ Il cluster non gestisce la password dell'utente principale in Amazon Web Services Secrets Manager. Se il cluster gestisce già la password dell'utente principale in Amazon Web Services Secrets Manager, non puoi modificare la chiave KMS utilizzata per crittografare il segreto.
+ Stai abilitando `ManageMasterUserPassword` la gestione della password utente principale in Amazon Web Services Secrets Manager. Se lo stai attivando `ManageMasterUserPassword` e 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.
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.
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
** NewDBClusterIdentifier **
Il nuovo identificatore per il cluster quando un cluster viene rinominato. Questo 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.
Ad esempio: `my-cluster2`
▬Tipo: stringa
Obbligatorio: no
** Port **
Numero della porta sulla quale il cluster accetta le connessioni.
Vincoli: deve essere un valore compreso tra a. `1150` `65535`
Impostazione predefinita: la stessa porta del cluster originale.
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 blocco 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
** RotateMasterUserPassword **
Speciifica se ruotare il segreto gestito da Amazon Web Services Secrets Manager per la password dell'utente principale.
Questa impostazione è valida solo se la password dell'utente principale è gestita da Amazon DocumentDB in Amazon Web Services Secrets Manager per il cluster. Il valore segreto contiene la password aggiornata.
Vincolo: è necessario applicare la modifica immediatamente quando si ruota la password dell'utente principale.
Tipo: Booleano
Obbligatorio: no
** ServerlessV2ScalingConfiguration **
Contiene la configurazione di scalabilità di un cluster Amazon DocumentDB Serverless.
Tipo: oggetto [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md)
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 `
▬Tipo: stringa
Obbligatorio: no
**VpcSecurityGroupIds. VpcSecurityGroupId**N.
Un elenco di gruppi di sicurezza del cloud privato virtuale (VPC) a cui apparterrà il 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
** DBSubnetGroupNotFoundFault **
`DBSubnetGroupName`non fa riferimento a un gruppo di sottoreti esistente.
Codice di stato HTTP: 404
** 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
** InvalidDBSecurityGroupState **
Lo stato del gruppo di sicurezza non consente l'eliminazione.
Codice di stato HTTP: 400
** InvalidDBSubnetGroupStateFault **
Il gruppo di sottoreti non può essere eliminato perché è in uso.
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
** NetworkTypeNotSupported **
Il tipo di rete non è supportato `DBSubnetGroup` né da nessuna delle versioni 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/ModifyDBCluster)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ModifyDBCluster)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ModifyDBCluster)