diff --git a/.changes/next-release/feature-AmazonRelationalDatabaseService-e21caa4.json b/.changes/next-release/feature-AmazonRelationalDatabaseService-e21caa4.json new file mode 100644 index 000000000000..5b286eeaaa37 --- /dev/null +++ b/.changes/next-release/feature-AmazonRelationalDatabaseService-e21caa4.json @@ -0,0 +1,6 @@ +{ + "type": "feature", + "category": "Amazon Relational Database Service", + "contributor": "", + "description": "Amazon RDS supports CloudWatch Database Insights. You can use the SDK to create, modify, and describe the DatabaseInsightsMode for your DB instances and clusters." +} diff --git a/services/rds/src/main/resources/codegen-resources/service-2.json b/services/rds/src/main/resources/codegen-resources/service-2.json index eec1601cfb66..259209cf2b8c 100644 --- a/services/rds/src/main/resources/codegen-resources/service-2.json +++ b/services/rds/src/main/resources/codegen-resources/service-2.json @@ -1780,7 +1780,7 @@ {"shape":"ResourceNotFoundFault"}, {"shape":"InvalidResourceStateFault"} ], - "documentation":"

Disables the HTTP endpoint for the specified DB cluster. Disabling this endpoint disables RDS Data API.

For more information, see Using RDS Data API in the Amazon Aurora User Guide.

This operation applies only to Aurora PostgreSQL Serverless v2 and provisioned DB clusters. To disable the HTTP endpoint for Aurora Serverless v1 DB clusters, use the EnableHttpEndpoint parameter of the ModifyDBCluster operation.

" + "documentation":"

Disables the HTTP endpoint for the specified DB cluster. Disabling this endpoint disables RDS Data API.

For more information, see Using RDS Data API in the Amazon Aurora User Guide.

This operation applies only to Aurora Serverless v2 and provisioned DB clusters. To disable the HTTP endpoint for Aurora Serverless v1 DB clusters, use the EnableHttpEndpoint parameter of the ModifyDBCluster operation.

" }, "DownloadDBLogFilePortion":{ "name":"DownloadDBLogFilePortion", @@ -1815,7 +1815,7 @@ {"shape":"ResourceNotFoundFault"}, {"shape":"InvalidResourceStateFault"} ], - "documentation":"

Enables the HTTP endpoint for the DB cluster. By default, the HTTP endpoint isn't enabled.

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

For more information, see Using RDS Data API in the Amazon Aurora User Guide.

This operation applies only to Aurora PostgreSQL Serverless v2 and provisioned DB clusters. To enable the HTTP endpoint for Aurora Serverless v1 DB clusters, use the EnableHttpEndpoint parameter of the ModifyDBCluster operation.

" + "documentation":"

Enables the HTTP endpoint for the DB cluster. By default, the HTTP endpoint isn't enabled.

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

For more information, see Using RDS Data API in the Amazon Aurora User Guide.

This operation applies only to Aurora Serverless v2 and provisioned DB clusters. To enable the HTTP endpoint for Aurora Serverless v1 DB clusters, use the EnableHttpEndpoint parameter of the ModifyDBCluster operation.

" }, "FailoverDBCluster":{ "name":"FailoverDBCluster", @@ -4307,6 +4307,10 @@ "shape":"String", "documentation":"

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 Setting up and enabling Enhanced Monitoring in the Amazon RDS User Guide.

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

Valid for Cluster Type: Multi-AZ DB clusters only

" }, + "DatabaseInsightsMode":{ + "shape":"DatabaseInsightsMode", + "documentation":"

Specifies the mode of Database Insights to enable for the cluster.

" + }, "EnablePerformanceInsights":{ "shape":"BooleanOptional", "documentation":"

Specifies 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 Cluster Type: Multi-AZ DB clusters only

" @@ -4610,6 +4614,10 @@ "shape":"BooleanOptional", "documentation":"

Specifies 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 for MySQL and PostgreSQL in the Amazon RDS User Guide.

This setting doesn't apply to the following DB instances:

" }, + "DatabaseInsightsMode":{ + "shape":"DatabaseInsightsMode", + "documentation":"

Specifies the mode of Database Insights to enable for the instance.

" + }, "EnablePerformanceInsights":{ "shape":"BooleanOptional", "documentation":"

Specifies whether to enable Performance Insights for the DB instance. For more information, see Using Amazon Performance Insights in the Amazon RDS User Guide.

This setting doesn't apply to RDS Custom DB instances.

" @@ -4774,6 +4782,10 @@ "shape":"BooleanOptional", "documentation":"

Specifies 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 about IAM database authentication, see IAM Database Authentication for MySQL and PostgreSQL in the Amazon RDS User Guide.

This setting doesn't apply to RDS Custom DB instances.

" }, + "DatabaseInsightsMode":{ + "shape":"DatabaseInsightsMode", + "documentation":"

Specifies the mode of Database Insights.

" + }, "EnablePerformanceInsights":{ "shape":"BooleanOptional", "documentation":"

Specifies whether to enable Performance Insights for the read replica.

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

This setting doesn't apply to RDS Custom DB instances.

" @@ -5695,6 +5707,10 @@ "shape":"String", "documentation":"

The ARN for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs.

This setting is only for non-Aurora Multi-AZ DB clusters.

" }, + "DatabaseInsightsMode":{ + "shape":"DatabaseInsightsMode", + "documentation":"

The mode of Database Insights that is enabled for the cluster.

" + }, "PerformanceInsightsEnabled":{ "shape":"BooleanOptional", "documentation":"

Indicates whether Performance Insights is enabled for the DB cluster.

This setting is only for non-Aurora Multi-AZ DB clusters.

" @@ -6939,6 +6955,10 @@ "shape":"Boolean", "documentation":"

Indicates whether mapping of Amazon Web Services Identity and Access Management (IAM) accounts to database accounts is enabled for the DB instance.

For a list of engine versions that support IAM database authentication, see IAM database authentication in the Amazon RDS User Guide and IAM database authentication in Aurora in the Amazon Aurora User Guide.

" }, + "DatabaseInsightsMode":{ + "shape":"DatabaseInsightsMode", + "documentation":"

The mode of Database Insights that is enabled for the instance.

" + }, "PerformanceInsightsEnabled":{ "shape":"BooleanOptional", "documentation":"

Indicates whether Performance Insights is enabled for the DB instance.

" @@ -8699,6 +8719,13 @@ "min":1, "pattern":"^arn:[A-Za-z][0-9A-Za-z-:._]*" }, + "DatabaseInsightsMode":{ + "type":"string", + "enum":[ + "standard", + "advanced" + ] + }, "DeleteBlueGreenDeploymentRequest":{ "type":"structure", "required":["BlueGreenDeploymentIdentifier"], @@ -12339,7 +12366,7 @@ }, "EnableHttpEndpoint":{ "shape":"BooleanOptional", - "documentation":"

Specifies whether to enable the HTTP endpoint for an Aurora Serverless v1 DB cluster. By default, the HTTP endpoint isn't enabled.

When enabled, the HTTP endpoint provides a connectionless web service API (RDS Data 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 RDS query editor.

For more information, see Using RDS Data API in the Amazon Aurora User Guide.

This parameter applies only to Aurora Serverless v1 DB clusters. To enable or disable the HTTP endpoint for an Aurora PostgreSQL Serverless v2 or provisioned DB cluster, use the EnableHttpEndpoint and DisableHttpEndpoint operations.

Valid for Cluster Type: Aurora DB clusters only

" + "documentation":"

Specifies whether to enable the HTTP endpoint for an Aurora Serverless v1 DB cluster. By default, the HTTP endpoint isn't enabled.

When enabled, the HTTP endpoint provides a connectionless web service API (RDS Data 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 RDS query editor.

For more information, see Using RDS Data API in the Amazon Aurora User Guide.

This parameter applies only to Aurora Serverless v1 DB clusters. To enable or disable the HTTP endpoint for an Aurora Serverless v2 or provisioned DB cluster, use the EnableHttpEndpoint and DisableHttpEndpoint operations.

Valid for Cluster Type: Aurora DB clusters only

" }, "CopyTagsToSnapshot":{ "shape":"BooleanOptional", @@ -12377,6 +12404,10 @@ "shape":"String", "documentation":"

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 Cluster Type: Multi-AZ DB clusters only

" }, + "DatabaseInsightsMode":{ + "shape":"DatabaseInsightsMode", + "documentation":"

Specifies the mode of Database Insights to enable for the cluster.

" + }, "EnablePerformanceInsights":{ "shape":"BooleanOptional", "documentation":"

Specifies 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 Cluster Type: Aurora DB clusters and Multi-AZ DB clusters

" @@ -12645,6 +12676,10 @@ "shape":"BooleanOptional", "documentation":"

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

This setting doesn't apply to Amazon Aurora. Mapping Amazon Web Services IAM accounts to database accounts is managed by the DB cluster.

For more information about IAM database authentication, see IAM Database Authentication for MySQL and PostgreSQL in the Amazon RDS User Guide.

This setting doesn't apply to RDS Custom DB instances.

" }, + "DatabaseInsightsMode":{ + "shape":"DatabaseInsightsMode", + "documentation":"

Specifies the mode of Database Insights to enable for the instance.

" + }, "EnablePerformanceInsights":{ "shape":"BooleanOptional", "documentation":"

Specifies whether to enable Performance Insights for the DB instance.

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

This setting doesn't apply to RDS Custom DB instances.

" @@ -15617,6 +15652,10 @@ "shape":"String", "documentation":"

An Amazon Web Services Identity and Access Management (IAM) role with a trust policy and a permissions policy that allows Amazon RDS to access your Amazon S3 bucket. For information about this role, see Creating an IAM role manually in the Amazon RDS User Guide.

" }, + "DatabaseInsightsMode":{ + "shape":"DatabaseInsightsMode", + "documentation":"

Specifies the mode of Database Insights to enable for the instance.

" + }, "EnablePerformanceInsights":{ "shape":"BooleanOptional", "documentation":"

Specifies whether to enable Performance Insights for the DB instance.

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

"