# 修改 Amazon RDS 数据库实例
<a name="Overview.DBInstance.Modifying"></a>

可以更改数据库实例的设置来完成添加额外存储或更改数据库实例类等任务。在本主题中，您可以了解如何修改 Amazon RDS 数据库实例并了解数据库实例的设置。

我们建议您在修改生产实例之前在测试实例上测试所有更改。这样做可以帮助您充分了解每项更改的影响。在升级数据库版本时，测试尤其重要。

对数据库实例的大多数修改都可以立即应用，也可以推迟到下一个维护时段。一些修改（例如，参数组更改）需要您手动重新启动数据库实例才能使更改生效。

**重要**  
一些修改可能会导致停机，因为 Amazon RDS 必须重新启动您的数据库实例才能使更改生效。在修改数据库实例设置之前，请先审核对数据库和应用程序的影响。

## 控制台
<a name="USER_ModifyInstance.Console"></a>

**修改数据库实例**

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

1. 在导航窗格中，选择**数据库**，然后选择要修改的数据库实例。

1. 选择**修改**。将显示**修改数据库实例**页面。

1. 根据需要更改任意设置。有关每项设置的信息，请参阅 [数据库实例的设置](USER_ModifyInstance.Settings.md)。

1. 当所有更改都达到您的要求时，选择**继续**并查看修改摘要。

1. （可选）选择**立即应用**以立即应用更改。选择此选项在某些情况下可能导致停机。有关更多信息，请参阅“[使用计划修改设置](USER_ModifyInstance.ApplyImmediately.md)”。

1. 在确认页面上，检查您的更改。如果更改正确无误，请选择 **Modify DB Instance（修改数据库实例）**保存更改。

   也可以选择 **Back** 编辑您的更改，或选择 **Cancel** 取消更改。

## AWS CLI
<a name="USER_ModifyInstance.CLI"></a>

要使用 AWS CLI 修改数据库实例，请调用 [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) 命令。指定数据库实例标识符以及要修改的选项值。有关各选项的信息，请参阅[数据库实例的设置](USER_ModifyInstance.Settings.md)。

**Example**  
以下代码修改 `mydbinstance`，将备份保留期设置为 1 周 (7 天)。该代码通过使用 `--deletion-protection` 启用删除保护。要禁用删除保护，请使用 `--no-deletion-protection`。将在下一维护时段使用 `--no-apply-immediately` 应用这些更改。使用 `--apply-immediately` 可立即应用更改。有关更多信息，请参阅 [使用计划修改设置](USER_ModifyInstance.ApplyImmediately.md)。  
对于 Linux、macOS 或 Unix：  

```
aws rds modify-db-instance \
    --db-instance-identifier {{mydbinstance}} \
    --backup-retention-period {{7}} \
    {{--deletion-protection}} \
    {{--no-apply-immediately}}
```
对于：Windows  

```
aws rds modify-db-instance ^
    --db-instance-identifier {{mydbinstance}} ^
    --backup-retention-period {{7}} ^
    {{--deletion-protection}} ^
    {{--no-apply-immediately}}
```

**Example**  
以下示例将存储卷添加到 RDS for Oracle 数据库实例。附加卷使用 gp3 存储，分配的存储空间为 5000 GiB，IOPS 为 12000。  

```
aws rds modify-db-instance \
     --db-instance-identifier my-oracle-instance \
     --additional-storage-volumes '[{ \
             "VolumeName": "rdsdbdata2", \
             "StorageType": "gp3",
             "AllocatedStorage": 5000, \
             "IOPS": 12000 \
         }]'
```

## RDS API
<a name="USER_ModifyInstance.API"></a>

要使用 Amazon RDS API 修改数据库实例，请调用 [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) 操作。指定数据库实例标识符，以及您要修改的设置参数。有关每个参数的信息，请参阅[数据库实例的设置](USER_ModifyInstance.Settings.md)。