Class: Aws::RDS::Types::ModifyDBClusterMessage

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-rds/types.rb

Overview

Note:

When making an API call, you may pass ModifyDBClusterMessage data as a hash:

{
  db_cluster_identifier: "String", # required
  new_db_cluster_identifier: "String",
  apply_immediately: false,
  backup_retention_period: 1,
  db_cluster_parameter_group_name: "String",
  vpc_security_group_ids: ["String"],
  port: 1,
  master_user_password: "String",
  option_group_name: "String",
  preferred_backup_window: "String",
  preferred_maintenance_window: "String",
  enable_iam_database_authentication: false,
  backtrack_window: 1,
  cloudwatch_logs_export_configuration: {
    enable_log_types: ["String"],
    disable_log_types: ["String"],
  },
  engine_version: "String",
  allow_major_version_upgrade: false,
  db_instance_parameter_group_name: "String",
  domain: "String",
  domain_iam_role_name: "String",
  scaling_configuration: {
    min_capacity: 1,
    max_capacity: 1,
    auto_pause: false,
    seconds_until_auto_pause: 1,
    timeout_action: "String",
    seconds_before_timeout: 1,
  },
  deletion_protection: false,
  enable_http_endpoint: false,
  copy_tags_to_snapshot: false,
  enable_global_write_forwarding: false,
  db_cluster_instance_class: "String",
  allocated_storage: 1,
  storage_type: "String",
  iops: 1,
  auto_minor_version_upgrade: false,
  monitoring_interval: 1,
  monitoring_role_arn: "String",
  enable_performance_insights: false,
  performance_insights_kms_key_id: "String",
  performance_insights_retention_period: 1,
  serverless_v2_scaling_configuration: {
    min_capacity: 1.0,
    max_capacity: 1.0,
  },
}

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#allocated_storageInteger

The amount of storage in gibibytes (GiB) to allocate to each DB instance in the Multi-AZ DB cluster.

Type: Integer

Valid for: Multi-AZ DB clusters only

Returns:

  • (Integer)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#allow_major_version_upgradeBoolean

A value that indicates whether major version upgrades are allowed.

Constraints: You must allow major version upgrades when specifying a value for the `EngineVersion` parameter that is a different major version than the DB cluster's current version.

Valid for: Aurora DB clusters only

Returns:

  • (Boolean)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#apply_immediatelyBoolean

A value that indicates whether the modifications in this request and any pending modifications are asynchronously applied as soon as possible, regardless of the `PreferredMaintenanceWindow` setting for the DB cluster. If this parameter is disabled, changes to the DB cluster are applied during the next maintenance window.

The `ApplyImmediately` parameter only affects the `EnableIAMDatabaseAuthentication`, `MasterUserPassword`, and `NewDBClusterIdentifier` values. If the `ApplyImmediately` parameter is disabled, then changes to the `EnableIAMDatabaseAuthentication`, `MasterUserPassword`, and `NewDBClusterIdentifier` values are applied during the next maintenance window. All other changes are applied immediately, regardless of the value of the `ApplyImmediately` parameter.

By default, this parameter is disabled.

Valid for: Aurora DB clusters and Multi-AZ DB clusters

Returns:

  • (Boolean)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#auto_minor_version_upgradeBoolean

A value that indicates whether minor engine upgrades are applied automatically to the DB cluster during the maintenance window. By default, minor engine upgrades are applied automatically.

Valid for: Multi-AZ DB clusters only

Returns:

  • (Boolean)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#backtrack_windowInteger

The target backtrack window, in seconds. To disable backtracking, set this value to 0.

Default: 0

Constraints:

  • If specified, this value must be set to a number from 0 to 259,200 (72 hours).

^

Valid for: Aurora MySQL DB clusters only

Returns:

  • (Integer)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#backup_retention_periodInteger

The number of days for which automated backups are retained. Specify a minimum value of 1.

Default: 1

Constraints:

  • Must be a value from 1 to 35

^

Valid for: Aurora DB clusters and Multi-AZ DB clusters

Returns:

  • (Integer)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#cloudwatch_logs_export_configurationTypes::CloudwatchLogsExportConfiguration

The configuration setting for the log types to be enabled for export to CloudWatch Logs for a specific DB cluster. The values in the list depend on the DB engine being used.

**RDS for MySQL**

Possible values are `error`, `general`, and `slowquery`.

**RDS for PostgreSQL**

Possible values are `postgresql` and `upgrade`.

**Aurora MySQL**

Possible values are `audit`, `error`, `general`, and `slowquery`.

**Aurora PostgreSQL**

Possible value is `postgresql`.

For more information about exporting CloudWatch Logs for Amazon RDS, see [ Publishing Database Logs to Amazon CloudWatch Logs] in the *Amazon RDS User Guide*.

For more information about exporting CloudWatch Logs for Amazon Aurora, see [Publishing Database Logs to Amazon CloudWatch Logs] in the *Amazon Aurora User Guide*.

Valid for: Aurora DB clusters and Multi-AZ DB clusters

[1]: docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch [2]: docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch


15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#copy_tags_to_snapshotBoolean

A value that indicates whether to copy all tags from the DB cluster to snapshots of the DB cluster. The default is not to copy them.

Valid for: Aurora DB clusters and Multi-AZ DB clusters

Returns:

  • (Boolean)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#db_cluster_identifierString

The DB cluster identifier for the cluster being modified. This parameter isn't case-sensitive.

Constraints: This identifier must match the identifier of an existing DB cluster.

Valid for: Aurora DB clusters and Multi-AZ DB clusters

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#db_cluster_instance_classString

The compute and memory capacity of each DB instance in the Multi-AZ DB cluster, for example db.m6g.xlarge. Not all DB instance classes are available in all Amazon Web Services Regions, or for all database engines.

For the full list of DB instance classes and availability for your engine, see [ DB Instance Class] in the *Amazon RDS User Guide*.

Valid for: Multi-AZ DB clusters only

[1]: docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#db_cluster_parameter_group_nameString

The name of the DB cluster parameter group to use for the DB cluster.

Valid for: Aurora DB clusters and Multi-AZ DB clusters

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#db_instance_parameter_group_nameString

The name of the DB parameter group to apply to all instances of the DB cluster.

<note markdown=“1”> When you apply a parameter group using the `DBInstanceParameterGroupName` parameter, the DB cluster isn't rebooted automatically. Also, parameter changes are applied immediately rather than during the next maintenance window.

</note>

Default: The existing name setting

Constraints:

  • The DB parameter group must be in the same DB parameter group family as this DB cluster.

  • The `DBInstanceParameterGroupName` parameter is valid in combination with the `AllowMajorVersionUpgrade` parameter for a major version upgrade only.

Valid for: Aurora DB clusters only

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#deletion_protectionBoolean

A value that indicates whether the DB cluster has deletion protection enabled. The database can't be deleted when deletion protection is enabled. By default, deletion protection isn't enabled.

Valid for: Aurora DB clusters and Multi-AZ DB clusters

Returns:

  • (Boolean)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#domainString

The Active Directory directory ID to move the DB cluster to. Specify `none` to remove the cluster from its current domain. The domain must be created prior to this operation.

For more information, see [Kerberos Authentication] in the *Amazon Aurora User Guide*.

Valid for: Aurora DB clusters only

[1]: docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#domain_iam_role_nameString

Specify the name of the IAM role to be used when making API calls to the Directory Service.

Valid for: Aurora DB clusters only

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#enable_global_write_forwardingBoolean

A value that indicates whether to enable this DB cluster to forward write operations to the primary cluster of an Aurora global database (GlobalCluster). By default, write operations are not allowed on Aurora DB clusters that are secondary clusters in an Aurora global database.

You can set this value only on Aurora DB clusters that are members of an Aurora global database. With this parameter enabled, a secondary cluster can forward writes to the current primary cluster and the resulting changes are replicated back to this cluster. For the primary DB cluster of an Aurora global database, this value is used immediately if the primary is demoted by the FailoverGlobalCluster API operation, but it does nothing until then.

Valid for: Aurora DB clusters only

Returns:

  • (Boolean)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#enable_http_endpointBoolean

A value that indicates whether to enable the HTTP endpoint for an Aurora Serverless v1 DB cluster. By default, the HTTP endpoint is disabled.

When enabled, the HTTP endpoint provides a connectionless web service API for running SQL queries on the Aurora Serverless v1 DB cluster. You can also query your database from inside the RDS console with the query editor.

For more information, see [Using the Data API for Aurora Serverless v1] in the *Amazon Aurora User Guide*.

Valid for: Aurora DB clusters only

[1]: docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html

Returns:

  • (Boolean)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#enable_iam_database_authenticationBoolean

A value that indicates whether to enable mapping of Amazon Web Services Identity and Access Management (IAM) accounts to database accounts. By default, mapping isn't enabled.

For more information, see [ IAM Database Authentication] in the *Amazon Aurora User Guide*.

Valid for: Aurora DB clusters only

[1]: docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html

Returns:

  • (Boolean)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#enable_performance_insightsBoolean

A value that indicates whether to turn on Performance Insights for the DB cluster.

For more information, see [ Using Amazon Performance Insights] in the *Amazon RDS User Guide*.

Valid for: Multi-AZ DB clusters only

[1]: docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html

Returns:

  • (Boolean)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#engine_versionString

The version number of the database engine to which you want to upgrade. Changing this parameter results in an outage. The change is applied during the next maintenance window unless `ApplyImmediately` is enabled.

To list all of the available engine versions for MySQL 5.6-compatible Aurora, use the following command:

`aws rds describe-db-engine-versions –engine aurora –query “DBEngineVersions[].EngineVersion”`

To list all of the available engine versions for MySQL 5.7-compatible and MySQL 8.0-compatible Aurora, use the following command:

`aws rds describe-db-engine-versions –engine aurora-mysql –query “DBEngineVersions[].EngineVersion”`

To list all of the available engine versions for Aurora PostgreSQL, use the following command:

`aws rds describe-db-engine-versions –engine aurora-postgresql –query “DBEngineVersions[].EngineVersion”`

To list all of the available engine versions for RDS for MySQL, use the following command:

`aws rds describe-db-engine-versions –engine mysql –query “DBEngineVersions[].EngineVersion”`

To list all of the available engine versions for RDS for PostgreSQL, use the following command:

`aws rds describe-db-engine-versions –engine postgres –query “DBEngineVersions[].EngineVersion”`

Valid for: Aurora DB clusters and Multi-AZ DB clusters

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#iopsInteger

The amount of Provisioned IOPS (input/output operations per second) to be initially allocated for each DB instance in the Multi-AZ DB cluster.

For information about valid Iops values, see [Amazon RDS Provisioned IOPS Storage to Improve Performance] in the *Amazon RDS User Guide*.

Constraints: Must be a multiple between .5 and 50 of the storage amount for the DB cluster.

Valid for: Multi-AZ DB clusters only

[1]: docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS

Returns:

  • (Integer)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#master_user_passwordString

The new password for the master database user. This password can contain any printable ASCII character except “/”, “”“, or ”@“.

Constraints: Must contain from 8 to 41 characters.

Valid for: Aurora DB clusters and Multi-AZ DB clusters

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#monitoring_intervalInteger

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off collecting Enhanced Monitoring metrics, specify 0. The default is 0.

If `MonitoringRoleArn` is specified, also set `MonitoringInterval` to a value other than 0.

Valid Values: `0, 1, 5, 10, 15, 30, 60`

Valid for: Multi-AZ DB clusters only

Returns:

  • (Integer)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#monitoring_role_arnString

The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. An example is `arn:aws:iam:123456789012:role/emaccess`. For information on creating a monitoring role, see [To create an IAM role for Amazon RDS Enhanced Monitoring] in the *Amazon RDS User Guide.*

If `MonitoringInterval` is set to a value other than 0, supply a `MonitoringRoleArn` value.

Valid for: Multi-AZ DB clusters only

[1]: docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#new_db_cluster_identifierString

The new DB cluster identifier for the DB cluster when renaming a DB cluster. This value is stored as a lowercase string.

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens

  • The first character must be a letter

  • Can't end with a hyphen or contain two consecutive hyphens

Example: `my-cluster2`

Valid for: Aurora DB clusters only

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#option_group_nameString

A value that indicates that the DB cluster should be associated with the specified option group.

DB clusters are associated with a default option group that can't be modified.

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#performance_insights_kms_key_idString

The Amazon Web Services KMS key identifier for encryption of Performance Insights data.

The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.

If you don't specify a value for `PerformanceInsightsKMSKeyId`, then Amazon RDS uses your default KMS key. There is a default KMS key for your Amazon Web Services account. Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.

Valid for: Multi-AZ DB clusters only

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#performance_insights_retention_periodInteger

The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).

Valid for: Multi-AZ DB clusters only

Returns:

  • (Integer)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#portInteger

The port number on which the DB cluster accepts connections.

Constraints: Value must be `1150-65535`

Default: The same port as the original DB cluster.

Valid for: Aurora DB clusters only

Returns:

  • (Integer)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#preferred_backup_windowString

The daily time range during which automated backups are created if automated backups are enabled, using the `BackupRetentionPeriod` parameter.

The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region. To view the time blocks available, see [ Backup window] in the *Amazon Aurora User Guide*.

Constraints:

  • Must be in the format `hh24:mi-hh24:mi`.

  • Must be in Universal Coordinated Time (UTC).

  • Must not conflict with the preferred maintenance window.

  • Must be at least 30 minutes.

Valid for: Aurora DB clusters and Multi-AZ DB clusters

[1]: docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#preferred_maintenance_windowString

The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: `ddd:hh24:mi-ddd:hh24:mi`

The default is a 30-minute window selected at random from an 8-hour block of time for each Amazon Web Services Region, occurring on a random day of the week. To see the time blocks available, see [ Adjusting the Preferred DB Cluster Maintenance Window] in the *Amazon Aurora User Guide*.

Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.

Constraints: Minimum 30-minute window.

Valid for: Aurora DB clusters and Multi-AZ DB clusters

[1]: docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow.Aurora

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#scaling_configurationTypes::ScalingConfiguration

The scaling properties of the DB cluster. You can only modify scaling properties for DB clusters in `serverless` DB engine mode.

Valid for: Aurora DB clusters only


15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#serverless_v2_scaling_configurationTypes::ServerlessV2ScalingConfiguration

Contains the scaling configuration of an Aurora Serverless v2 DB cluster.

For more information, see [Using Amazon Aurora Serverless v2] in the *Amazon Aurora User Guide*.

[1]: docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.html


15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#storage_typeString

Specifies the storage type to be associated with the DB cluster.

Valid values: `io1`

When specified, a value for the `Iops` parameter is required.

Default: `io1`

Valid for: Multi-AZ DB clusters only

Returns:

  • (String)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end

#vpc_security_group_idsArray<String>

A list of VPC security groups that the DB cluster will belong to.

Valid for: Aurora DB clusters and Multi-AZ DB clusters

Returns:

  • (Array<String>)

15098
15099
15100
15101
15102
15103
15104
15105
15106
15107
15108
15109
15110
15111
15112
15113
15114
15115
15116
15117
15118
15119
15120
15121
15122
15123
15124
15125
15126
15127
15128
15129
15130
15131
15132
15133
15134
15135
15136
# File 'lib/aws-sdk-rds/types.rb', line 15098

class ModifyDBClusterMessage < Struct.new(
  :db_cluster_identifier,
  :new_db_cluster_identifier,
  :apply_immediately,
  :backup_retention_period,
  :db_cluster_parameter_group_name,
  :vpc_security_group_ids,
  :port,
  :master_user_password,
  :option_group_name,
  :preferred_backup_window,
  :preferred_maintenance_window,
  :enable_iam_database_authentication,
  :backtrack_window,
  :cloudwatch_logs_export_configuration,
  :engine_version,
  :allow_major_version_upgrade,
  :db_instance_parameter_group_name,
  :domain,
  :domain_iam_role_name,
  :scaling_configuration,
  :deletion_protection,
  :enable_http_endpoint,
  :copy_tags_to_snapshot,
  :enable_global_write_forwarding,
  :db_cluster_instance_class,
  :allocated_storage,
  :storage_type,
  :iops,
  :auto_minor_version_upgrade,
  :monitoring_interval,
  :monitoring_role_arn,
  :enable_performance_insights,
  :performance_insights_kms_key_id,
  :performance_insights_retention_period,
  :serverless_v2_scaling_configuration)
  SENSITIVE = []
  include Aws::Structure
end