---
title: "GET /#Action=ModifyDBCluster"
method: GET
path: "/#Action=ModifyDBCluster"
---

# GET /#Action=ModifyDBCluster

`GET /#Action=ModifyDBCluster`

Modify the settings for an Amazon Aurora DB cluster or a Multi-AZ DB cluster. You can change one or more settings by specifying these parameters and the new values in the request.

For more information on Amazon Aurora DB clusters, see [What is Amazon Aurora?](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the _Amazon Aurora User Guide_.

For more information on Multi-AZ DB clusters, see [Multi-AZ DB cluster deployments](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html) in the _Amazon RDS User Guide_.

## Query parameters

- `DBClusterIdentifier` string, required
- `NewDBClusterIdentifier` string
- `ApplyImmediately` boolean
- `BackupRetentionPeriod` integer
- `DBClusterParameterGroupName` string
- `VpcSecurityGroupIds` string[]
- `Port` integer
- `MasterUserPassword` string
- `OptionGroupName` string
- `PreferredBackupWindow` string
- `PreferredMaintenanceWindow` string
- `EnableIAMDatabaseAuthentication` boolean
- `BacktrackWindow` integer
- `CloudwatchLogsExportConfiguration` object — <p>The configuration setting for the log types to be enabled for export to CloudWatch Logs for a specific DB instance or DB cluster.</p> <p>The <code>EnableLogTypes</code> and <code>DisableLogTypes</code> arrays determine which logs will be exported (or not exported) to CloudWatch Logs. The values within these arrays depend on the DB engine being used.</p> <p>For more information about exporting CloudWatch Logs for Amazon RDS DB instances, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch">Publishing Database Logs to Amazon CloudWatch Logs </a> in the <i>Amazon RDS User Guide</i>.</p> <p>For more information about exporting CloudWatch Logs for Amazon Aurora DB clusters, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch">Publishing Database Logs to Amazon CloudWatch Logs</a> in the <i>Amazon Aurora User Guide</i>.</p>
  - `EnableLogTypes` String[] — The list of log types to enable.
  - `DisableLogTypes` String[] — The list of log types to disable.
- `EngineVersion` string
- `AllowMajorVersionUpgrade` boolean
- `DBInstanceParameterGroupName` string
- `Domain` string
- `DomainIAMRoleName` string
- `ScalingConfiguration` object — <p>Contains the scaling configuration of an Aurora Serverless v1 DB cluster.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html">Using Amazon Aurora Serverless v1</a> in the <i>Amazon Aurora User Guide</i>.</p>
  - `MinCapacity` integer — <p>The minimum capacity for an Aurora DB cluster in <code>serverless</code> DB engine mode.</p> <p>For Aurora MySQL, valid capacity values are <code>1</code>, <code>2</code>, <code>4</code>, <code>8</code>, <code>16</code>, <code>32</code>, <code>64</code>, <code>128</code>, and <code>256</code>.</p> <p>For Aurora PostgreSQL, valid capacity values are <code>2</code>, <code>4</code>, <code>8</code>, <code>16</code>, <code>32</code>, <code>64</code>, <code>192</code>, and <code>384</code>.</p> <p>The minimum capacity must be less than or equal to the maximum capacity.</p>
  - `MaxCapacity` integer — <p>The maximum capacity for an Aurora DB cluster in <code>serverless</code> DB engine mode.</p> <p>For Aurora MySQL, valid capacity values are <code>1</code>, <code>2</code>, <code>4</code>, <code>8</code>, <code>16</code>, <code>32</code>, <code>64</code>, <code>128</code>, and <code>256</code>.</p> <p>For Aurora PostgreSQL, valid capacity values are <code>2</code>, <code>4</code>, <code>8</code>, <code>16</code>, <code>32</code>, <code>64</code>, <code>192</code>, and <code>384</code>.</p> <p>The maximum capacity must be greater than or equal to the minimum capacity.</p>
  - `AutoPause` boolean — <p>A value that indicates whether to allow or disallow automatic pause for an Aurora DB cluster in <code>serverless</code> DB engine mode. A DB cluster can be paused only when it's idle (it has no connections).</p> <note> <p>If a DB cluster is paused for more than seven days, the DB cluster might be backed up with a snapshot. In this case, the DB cluster is restored when there is a request to connect to it.</p> </note>
  - `SecondsUntilAutoPause` integer — <p>The time, in seconds, before an Aurora DB cluster in <code>serverless</code> mode is paused.</p> <p>Specify a value between 300 and 86,400 seconds.</p>
  - `TimeoutAction` string — <p>The action to take when the timeout is reached, either <code>ForceApplyCapacityChange</code> or <code>RollbackCapacityChange</code>.</p> <p> <code>ForceApplyCapacityChange</code> sets the capacity to the specified value as soon as possible.</p> <p> <code>RollbackCapacityChange</code>, the default, ignores the capacity change if a scaling point isn't found in the timeout period.</p> <important> <p>If you specify <code>ForceApplyCapacityChange</code>, connections that prevent Aurora Serverless v1 from finding a scaling point might be dropped.</p> </important> <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.how-it-works.html#aurora-serverless.how-it-works.auto-scaling"> Autoscaling for Aurora Serverless v1</a> in the <i>Amazon Aurora User Guide</i>.</p>
  - `SecondsBeforeTimeout` integer — <p>The amount of time, in seconds, that Aurora Serverless v1 tries to find a scaling point to perform seamless scaling before enforcing the timeout action. The default is 300.</p> <p>Specify a value between 60 and 600 seconds.</p>
- `DeletionProtection` boolean
- `EnableHttpEndpoint` boolean
- `CopyTagsToSnapshot` boolean
- `EnableGlobalWriteForwarding` boolean
- `DBClusterInstanceClass` string
- `AllocatedStorage` integer
- `StorageType` string
- `Iops` integer
- `AutoMinorVersionUpgrade` boolean
- `MonitoringInterval` integer
- `MonitoringRoleArn` string
- `EnablePerformanceInsights` boolean
- `PerformanceInsightsKMSKeyId` string
- `PerformanceInsightsRetentionPeriod` integer
- `ServerlessV2ScalingConfiguration` object — <p>Contains the scaling configuration of an Aurora Serverless v2 DB cluster.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.html">Using Amazon Aurora Serverless v2</a> in the <i>Amazon Aurora User Guide</i>.</p>
  - `MinCapacity` number, double — The minimum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. You can specify ACU values in half-step increments, such as 8, 8.5, 9, and so on. The smallest value that you can use is 0.5.
  - `MaxCapacity` number, double — The maximum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. You can specify ACU values in half-step increments, such as 40, 40.5, 41, and so on. The largest value that you can use is 128.
- `NetworkType` string
- `ManageMasterUserPassword` boolean
- `RotateMasterUserPassword` boolean
- `MasterUserSecretKmsKeyId` string
- `EngineMode` string
- `AllowEngineModeChange` boolean
- `Action` 'ModifyDBCluster', required
- `Version` '2014-10-31', required

## Response `200`

Success

## Other responses

- `480` — DBClusterNotFoundFault
- `481` — InvalidDBClusterStateFault
- `482` — StorageQuotaExceededFault
- `483` — DBSubnetGroupNotFoundFault
- `484` — InvalidVPCNetworkStateFault
- `485` — InvalidDBSubnetGroupStateFault
- `486` — InvalidSubnet
- `487` — DBClusterParameterGroupNotFoundFault
- `488` — InvalidDBSecurityGroupStateFault
- `489` — InvalidDBInstanceStateFault
- `490` — DBClusterAlreadyExistsFault
- `491` — DBInstanceAlreadyExistsFault
- `492` — DomainNotFoundFault

---

[API](https://skmtc.net/aws/apis/rds.md) · [All operations](https://skmtc.net/aws/apis/rds/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/rds/versions/e6b3ad7df19b/schema)