本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 修改 Amazon DocumentDB 实例
您可以使用 AWS 管理控制台 或修改您的 Amazon DocumentDB 实例。 AWS CLI要修改某个实例，该实例必须处于*可用* 状态。您无法修改已停止的实例。如果集群已停止，则首先启动集群，等待实例进入*可用* 状态，然后进行所需修改。有关更多信息，请参阅 [停止和启动 Amazon DocumentDB 集群](db-cluster-stop-start.md)。
------
#### [ Using the AWS 管理控制台 ]
要使用控制台修改特定的 Amazon DocumentDB 实例，请完成以下步骤。
1. [登录 AWS 管理控制台，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. 在导航窗格中，选择 **Clusters（集群）**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 在集群导航框中，您将看到“**集群标识符**”列。您的实例列于集群下，类似于以下屏幕截图。
![\[“集群”表，显示了“集群标识符”列下的集群列表，其中实例嵌套在集群内。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/choose-clusters.png)
1. 勾选您希望修改的实例左侧的复选框。
1. 选择 **Actions (操作)**，然后选择 **Modify (修改)**。
1. 在 **Modify instance: (修改实例: >)** 窗格中，进行所需更改。您可以进行以下更改：
+ **实例规范**：实例标识符和类。实例标识符命名约束：
+ **实例标识符**-输入一个名称，该名称对于您在 AWS 账户 当前地区拥有的所有实例都具有唯一性。实例标识符必须包含 [1-63] 个字母数字字符或连字符，以字母作为首字符，并且不能以连字符结尾或不能包含两个连续连字符。
+ **实例类**：从下拉菜单中，为您的 Amazon DocumentDB 实例选择一个实例类。有关更多信息，请参阅 [管理实例类](db-instance-classes.md)。
+ **证书颁发机构**：此实例的服务器证书。有关更多信息，请参阅 [更新您的 Amazon DocumentDB TLS 证书](ca_cert_rotation.md)。
+ **失效转移**：在失效转移期间，具有最高提升层的实例将被提升为主实例。有关更多信息，请参阅 [Amazon DocumentDB 失效转移](failover.md)。
+ **维护**：在维护窗口中将待处理的修改或修补程序应用于集群中的实例。
1. 完成后，选择 **Continue (继续)** 以查看更改摘要。
1. 在确认您的更改后，您可以立即应用这些更改，也可以在 **Scheduling of modifications (修改计划)** 下的下一个维护时段内应用这些更改。选择 **Modify instance (修改实例)** 以保存更改。或者，您可以选择 **Cancel (取消)** 以放弃更改。
需要几分钟时间才能应用更改。只有在实例状态为 *available (可用)* 时，才能使用实例。您可以使用控制台或 AWS CLI监控实例状态。有关更多信息，请参阅 [监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
要使用修改特定的 Amazon DocumentDB 实例 AWS CLI，请使用`modify-db-instance`带以下参数的。有关更多信息，请参阅[修改DBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html)。以下代码为实例 `sample-instance` 将实例类修改为 `db.r5.large`。
**参数**
+ **--db-instance-identifier**：必需。要修改的实例的标识符。
+ **--db-instance-class**：可选。实例的新计算和内存容量；例如，`db.r5.large`。并非所有实例类型在所有 AWS 区域中都可用。如果您修改实例类，则在更改期间会发生中断。更改在下一个维护时段内应用，除非此请求的 `ApplyImmediately` 指定为真实。
+ **--apply-immediately** 或 **--no-apply-immediately**：可选。指定应立即应用此修改，还是等到下一个维护时段。如果省略此参数，则会在下一个维护时段执行修改。
**Example**
对于 Linux、macOS 或 Unix：
```
aws docdb modify-db-instance \
--db-instance-identifier sample-instance \
--db-instance-class db.r5.large \
--apply-immediately
```
对于 Windows：
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-instance ^
--db-instance-class db.r5.large ^
--apply-immediately
```
此操作的输出将类似于下文。
```
{
"DBInstances": [
{
"DBInstanceIdentifier": "sample-instance-1",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "modifying",
"Endpoint": {
"Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-01-10T22:18:55.921Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1a",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
"PendingModifiedValues": {
"DBInstanceClass": "db.r5.large"
},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
]
}
```
需要几分钟时间才能应用修改。只有在实例状态为 *available (可用)* 时，才能使用实例。您可以使用 AWS 管理控制台 或监控实例的状态 AWS CLI。有关更多信息，请参阅 [监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------