# 应用 Amazon RDS 建议
<a name="USERRecommendationsManage.ApplyRecommendation"></a>

要使用 Amazon RDS 控制台应用 Amazon RDS 建议，请在详细信息页面中选择基于配置的建议或受影响的资源。然后，选择立即应用该建议，或将其安排在下一个维护时段。资源可能需要重启才能使更改生效。对于一些数据库参数组建议，您可能需要重启资源。

基于阈值的主动建议或基于异常的被动建议不具有应用选项，可能需要进一步审查。

## 控制台
<a name="USERRecommendationsManage.ApplyRecommendation-Console"></a>

**应用基于配置的建议**

1. 登录 Amazon Web Services 管理控制台 并通过以下网址打开 Amazon RDS 控制台：[https://console.aws.amazon.com/rds/](https://console.amazonaws.cn/rds/)。

1. 在导航窗格中，执行以下任一操作：
   + 选择**建议**。

     此时将出现**建议**页面，其中包含所有建议的列表。
   + 选择**数据库**，然后在数据库页中为资源选择**建议**。

     详细信息显示在所选建议的**建议**选项卡中。
   + 在**建议**页或**数据库**页的**建议**选项卡中，为活动的建议选择**检测**。

     此时会显示建议详细信息页面。

1. 在建议详细信息页面中选择一个建议或一个或多个受影响的资源，然后执行以下任一操作：
   + 选择**应用**，然后选择**立即应用**以立即应用建议。
   + 选择**应用**，然后选择**在下一个维护时段内应用**以计划在下一个维护时段中应用。

     在到达下一个维护时段之前，所选建议的状态将更新为待定。  
![\[选择了一个活动建议，并在控制台中突出显示了“应用”按钮及其选项。\]](http://docs.amazonaws.cn/AmazonRDS/latest/UserGuide/images/Recommendations_Apply_Defer.png)

   将显示一个确认窗口。

1. 选择**确认应用**以应用建议。此窗口将确认资源是需要自动重启还是手动重启才能使更改生效。

   以下示例显示了立即应用建议的确认窗口。  
![\[控制台中用于立即应用建议的确认窗口\]](http://docs.amazonaws.cn/AmazonRDS/latest/UserGuide/images/Recommendations_ApplyImmediately.png)

   以下示例显示了计划在下一个维护时段中应用建议的确认窗口。  
![\[控制台中计划在下一个维护时段中应用建议的确认窗口\]](http://docs.amazonaws.cn/AmazonRDS/latest/UserGuide/images/Recommendations_Defer.png)

   当应用的建议成功或失败时，横幅会显示一条消息。

   以下示例显示了带有成功消息的横幅。  
![\[控制台中的一条横幅，其中显示了该消息以及将应用该建议的资源数量\]](http://docs.amazonaws.cn/AmazonRDS/latest/UserGuide/images/Recommendation-Apply-Banner.png)

   以下示例显示了带有失败消息的横幅。  
![\[控制台中的一条横幅，其中显示了该消息以及包含未能应用建议的资源和失败的原因\]](http://docs.amazonaws.cn/AmazonRDS/latest/UserGuide/images/Recommendation-Apply-Banner-failure.png)

## RDS API
<a name="USERRecommendationsManage.ApplyRecommendation-API"></a>

**使用 Amazon RDS API 应用基于配置的 RDS 建议**

1. 使用 [DescribeDBRecommendations](https://docs.amazonaws.cn/AmazonRDS/latest/APIReference/API_DescribeDBRecommendations.html) 操作。输出中的 `RecommendedActions` 可以有一个或多个建议的操作。

1. 对步骤 1 中的每个建议操作使用 [RecommendedAction](https://docs.amazonaws.cn/AmazonRDS/latest/APIReference/API_RecommendedAction.html) 对象。输出包含 `Operation` 和 `Parameters`。

   以下示例显示了带有一个建议操作的输出。

   ```
       "RecommendedActions": [
           {
               "ActionId": "0b19ed15-840f-463c-a200-b10af1b552e3",
               "Title": "Turn on auto backup", // localized
               "Description": "Turn on auto backup for my-mysql-instance-1", // localized
               "Operation": "ModifyDbInstance",
               "Parameters": [
                   {
                       "Key": "DbInstanceIdentifier",
                       "Value": "my-mysql-instance-1"
                   },
                   {
                       "Key": "BackupRetentionPeriod",
                       "Value": "7"
                   }
               ],
               "ApplyModes": ["immediately", "next-maintenance-window"],
               "Status": "applied"
           },
           ... // several others
       ],
   ```

1. 对步骤 2 的输出中的每个建议操作使用 `operation` 并输入 `Parameters` 值。

1. 步骤 2 中的操作成功后，使用 [ModifyDBRecommendation](https://docs.amazonaws.cn/AmazonRDS/latest/APIReference/API_ModifyDBRecommendation.html) 操作修改建议状态。