View a markdown version of this page

ModifyDBRecommendation - Amazon Relational Database Service

ModifyDBRecommendation

Updates the recommendation status and recommended action status for the specified recommendation.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

RecommendationId

The identifier of the recommendation to update.

Type: String

Required: Yes

Locale

The language of the modified recommendation.

Type: String

Required: No

RecommendedActionUpdates.member.N

The list of recommended action status to update. You can update multiple recommended actions at one time.

Type: Array of RecommendedActionUpdate objects

Required: No

Status

The recommendation status to update.

Valid values:

  • active

  • dismissed

Type: String

Required: No

Response Elements

The following element is returned by the service.

DBRecommendation

The recommendation for your DB instances, DB clusters, and DB parameter groups.

Type: DBRecommendation object

Errors

For information about the errors that are common to all actions, see Common Error Types.

Examples

Modifying the recommended action status for a recommendation

This example illustrates one usage of ModifyDBRecommendation.

Sample Request

https://rds.us-east-1.amazonaws.com/ ?Action=ModifyDBRecommendation &RecommendationId=15e811d7-ec23-4d94-8d28-74cd2e7729ad &RecommendedActionUpdates.member.1.ActionId=806effbdc8853c4bf0e794c0c240ee8e &RecommendedActionUpdates.member.1.Status=applied &Locale=es &SignatureMethod=HmacSHA256 &SignatureVersion=4 &Version=2014-10-31 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20230222/us-east-1/rds/aws4_request &X-Amz-Date=20230222T200807Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=2d4f2b9e8abc31122b5546f94c0499bba47de813cb875f9b9c78e8e19c9afe1b

Sample Response

15e811d7-ec23-4d94-8d28-74cd2e7729ad config_recommendation::multi_az_instance low arn:aws:rds:us-west-2:636812126935:db:mariadb-instance pending 2023-10-05T18:04:04.017000+00:00 2023-10-20T19:17:18+00:00 **1 resource** is not a Multi-AZ instance Set up Multi-AZ for the impacted DB instances We recommend that you use Multi-AZ deployment. The Multi-AZ deployments enhance the availability and durability of the DB instance. Click Info for more details about Multi-AZ deployment and pricing. 806effbdc8853c4bf0e794c0c240ee8e modifyDbInstance MultiAZ true DBInstanceIdentifier mariadb-instance immediately next-maintenance-window applied resourceArn arn:aws:rds:us-west-2:636812126935:db:mariadb-instance engineName mariadb reliability RDS **[resource-count] resources** are not Multi-AZ instances Set up Multi-AZ for the impacted DB instances Data availability at risk In an Amazon RDS Multi-AZ deployment, Amazon RDS automatically creates a primary database instance and replicates the data to an instance in a different availability zone. When it detects a failure, Amazon RDS automatically fails over to a standby instance without manual intervention. Pricing for Amazon RDS Multi-AZ https://aws.amazon.com/rds/features/multi-az/#Pricing

Modifying the recommendation status for the specified recommendation ID

This example illustrates one usage of ModifyDBRecommendation.

Sample Request

https://rds.us-east-1.amazonaws.com/ ?Action=ModifyDBRecommendation &RecommendationId=8c9132b0-267d-4493-b3c4-aedd0920809d &Status=dismissed &Locale=es &SignatureMethod=HmacSHA256 &SignatureVersion=4 &Version=2014-10-31 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20230222/us-east-1/rds/aws4_request &X-Amz-Date=20230222T200807Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=2d4f2b9e8abc31122b5546f94c0499bba47de813cb875f9b9c78e8e19c9afe1b

Sample Response

8c9132b0-267d-4493-b3c4-aedd0920809d config_recommendation::enhanced_monitoring_off low arn:aws:rds:us-west-2:636812126935:db:mariadb-instance dismissed 2023-10-05T18:04:03.957000+00:00 2023-10-20T19:20:22+00:00 **1 resource** doesn't have Enhanced Monitoring enabled Turn on Enhanced Monitoring Your database resources don't have Enhanced Monitoring turned on. Enhanced Monitoring provides real-time operating system metrics for monitoring and troubleshooting. a2e5e55f28854f9ec12f45c227d85f48 modifyDbInstance MonitoringInterval 60 DBInstanceIdentifier mariadb-instance immediately ready resourceArn arn:aws:rds:us-west-2:636812126935:db:mariadb-instance engineName mariadb recommendedValue 60 reliability RDS **[resource-count] resources** don't have Enhanced Monitoring enabled Turn on Enhanced Monitoring Reduced operational visibility Enhanced Monitoring for Amazon RDS provides additional visibility on the health of your DB instances. We recommend that you turn on Enhanced Monitoring. When the Enhanced Monitoring option is turned on for your DB instance, it collects vital operating system metrics and process information. Turning Enhanced Monitoring on and off https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: