本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Amazon DocumentDB 实例生命周期
Amazon DocumentDB 实例的生命周期包括创建、修改、维护并升级、执行备份和还原、重启以及删除实例。本节提供有关如何完成这些过程的信息。
**Topics**
+ [添加实例](db-instance-add.md)
+ [描述实例](db-instance-view-details.md)
+ [修改实例](db-instance-modify.md)
+ [重启实例](db-instance-reboot.md)
+ [删除实例](db-instance-delete.md)
您可以使用 AWS 管理控制台 或创建新的 Amazon DocumentDB 实例。 AWS CLI要将实例添加到集群，该集群必须处于*可用* 状态。您无法将实例添加到已停止的集群。如果集群已停止，则首先启动集群，等待集群进入*可用* 状态，然后添加实例。有关更多信息，请参阅 [停止和启动 Amazon DocumentDB 集群](db-cluster-stop-start.md)。
**注意**
如果您使用控制台创建 Amazon DocumentDB 集群，则同时会自动为您创建实例。如果您要创建其他实例，请使用以下过程之一。
# 向集群添加 Amazon DocumentDB 实例
------
#### [ Using the AWS 管理控制台 ]
使用以下过程通过 Amazon DocumentDB 控制台为集群创建实例。
1. [登录 AWS 管理控制台，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. 在导航窗格中，选择**集群**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 要选择希望将实例添加到的集群，请选择该集群名称左侧的按钮。
1. 选择 **Actions (操作)**，然后选择 **Add instance (添加实例)**。
1. 在 **Add instance to: (将实例添加到:)** 页面中，对要添加到集群的每个实例重复以下步骤。您最多可以有 15。
1. **Instance identifier (实例标识符)**：您可以输入此实例的唯一标识符，或允许 Amazon DocumentDB 基于集群标识符提供实例标识符。
实例命名约束：
+ 长度为 [1-63] 个字母、数字或连字符。
+ 第一个字符必须是字母。
+ 不能以连字符结尾或包含两个连续的连字符。
+ 每个区域的 Amazon RDS、Neptune 和 Amazon DocumentDB 中的所有实例都必须是唯一 AWS 账户的。
1. **Instance class (实例类)**：从下拉列表中，为该实例选择所需的实例类型。
1. **Promotion tier (提升层)**：从下拉列表中，选择该实例的提升层，或者选择* No preference (无首选项) *以允许 Amazon DocumentDB 为您的实例设置提升层。数字越小，意味着优先级越高。有关更多信息，请参阅 [控制失效转移目标](failover.md#failover-target_control)。
1. 要添加更多实例，请选择 **Add additional instances (添加额外实例)**，并重复步骤 a、b 和 c。
1. 完成此操作。
+ 要将实例添加到集群，请选择 **Create (创建)**。
+ 要取消操作，请选择**取消**。
创建实例需要几分钟时间。您可以使用控制台或 AWS CLI 查看实例的状态。有关更多信息，请参阅 [监控实例的状态](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
使用带有以下参数的`create-db-instance` AWS CLI 操作为您的集群创建主实例。
+ **--db-instance-class**：必需。实例的计算和内存容量，例如，`db.m4.large`。并非所有实例类在所有 AWS 区域中都可用。
+ **--db-instance-identifier**：必需。标识实例的一个 字符串。
实例命名约束：
+ 长度为 [1-63] 个字母、数字或连字符。
+ 第一个字符必须是字母。
+ 不能以连字符结尾或包含两个连续的连字符。
+ 每个区域的 Amazon RDS、Neptune 和 Amazon DocumentDB 中的所有实例都必须是唯一 AWS 账户的。
+ **--engine**：必需。必须是 `docdb`。
+ **--availability-zone**：可选。要在其中创建此实例的可用区。使用此参数在不同可用区中找到您的实例，以增强容错能力。有关更多信息，请参阅 [Amazon DocumentDB 高可用性和复制](replication.md)。
+ **--promotion-tier**：可选。此实例的失效转移优先级层。必须介于 0 与 15 之间，数字越小，优先级越高。有关更多信息，请参阅 [控制失效转移目标](failover.md#failover-target_control)。
1. **首先，确定您可以在哪些可用区中创建您的实例。**
如果要在创建实例前指定可用区，请运行以下命令以确定哪些可用区可用于您的 Amazon DocumentDB 集群。
对于 Linux、macOS 或 Unix：
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
对于 Windows：
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
此操作的输出将类似于下文。
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **其次，确定您可以在您的区域中创建哪些实例类。**
要确定您所在区域中可用的实例类，请运行以下命令。从输出中，为要添加到 Amazon DocumentDB 集群的实例选择实例类。
对于 Linux、macOS 或 Unix：
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
对于 Windows：
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
此操作的输出将类似于下文。
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **最后，将实例添加到您的 Amazon DocumentDB 集群。**
要将实例添加到您的 Amazon DocumentDB 集群，请运行以下命令。
对于 Linux、macOS 或 Unix：
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance-2 \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.xlarge \
--engine docdb
```
对于 Windows：
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster ^
--db-instance-identifier sample-instance-2 ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.xlarge ^
--engine docdb
```
此操作的输出将类似于下文。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.xlarge",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
创建实例需要几分钟时间。您可以使用控制台或 AWS CLI 查看实例的状态。有关更多信息，请参阅 [监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
# 描述 Amazon DocumentDB 实例
您可以使用 Amazon DocumentDB 管理控制台或查看与您的 Amazon DocumentDB 实例相关的连接终端节点、安全组 VPCs、证书颁发机构和参数组等详细信息。 AWS CLI
------
#### [ Using the AWS 管理控制台 ]
要使用 AWS 管理控制台查看实例的详细信息，请执行以下步骤。
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. 在实例列表中，选择要查看其详细信息的实例的名称。有关实例的信息分为以下几组：
+ **Summary (摘要)**：有关实例的一般信息，包括引擎版本、类、状态和所有待处理维护。
+ **Connectivity & Security (连接性和安全性)**：**Connect (连接) **部分列出要使用 mongo Shell 或应用程序连接到此实例的连接端点。**Security Groups (安全组)** 部分列出与此实例关联的安全组及其 VPC ID 和描述。
+ **配置**：**详情**部分列出了实例的配置和状态，包括实例的 Amazon 资源名称 (ARN)、端点、角色、类和证书颁发机构。其中还列出实例的安全性和网络设置以及备份信息。**Cluster details (集群详细信息)** 部分列出此实例所属集群的详细信息。**Cluster instances (集群实例)** 部分列出属于集群的所有实例，其中包括每个实例的角色和集群参数组状态。
**注意**
您可以通过选择紧邻 **集群详情**标题的**修改**，修改与您的实例关联的集群。有关更多信息，请参阅 [修改 Amazon DocumentDB 集群](db-cluster-modify.md)。
+ **监控**- CloudWatch 记录此实例的指标。有关更多信息，请参阅 [使用以下方式监控亚马逊 DocumentDB CloudWatch](cloud_watch.md)。
+ **事件和标签**：**最近事件**部分列出了这个实例的最近事件。Amazon DocumentDB 记录与集群、实例、快照、安全组和集群参数组相关的事件。此信息包括与每个事件关联的日期、时间和消息。**Tags (标签)** 部分列出附加该集群的标签。有关更多信息，请参阅 [标记 Amazon DocumentDB 资源](tagging.md)。
------
#### [ Using the AWS CLI ]
要使用查看您的 Amazon DocumentDB 实例的详细信息 AWS CLI，请使用如下示例所示的`describe-db-clusters`命令。有关更多信息，请参阅 *Amazon DocumentDB 资源管理 API 参考*中的 [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html)。
**注意**
对于某些管理功能（如集群和实例生命周期管理），Amazon DocumentDB 利用与 Amazon RDS 共享的操作技术。`filterName=engine,Values=docdb` 筛选条件参数仅返回 Amazon DocumentDB 集群。
1. **列出所有 Amazon DocumentDB 实例。**
以下 AWS CLI 代码列出了某个区域中所有 Amazon DocumentDB 实例的详细信息。
对于 Linux、macOS 或 Unix：
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
对于 Windows：
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **列出指定 Amazon DocumentDB 实例的所有详细信息**
以下代码列出了 `sample-cluster-instance` 的详细信息。将 `--db-instance-identifier` 参数包含在实例名称中，会将输出限制为该特定实例的信息。
对于 Linux、macOS 或 Unix：
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
对于 Windows：
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
此操作的输出将类似于以下内容：
```
{
"DBInstances": [
{
"DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
"DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"DBInstanceClass": "db.r5.large",
"DBInstanceStatus": "creating",
"AutoMinorVersionUpgrade": true,
"PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
"BackupRetentionPeriod": 1,
"StorageEncrypted": true,
"DBClusterIdentifier": "sample-cluster",
"EngineVersion": "3.6.0",
"AvailabilityZone": "us-east-1a",
"Engine": "docdb",
"PromotionTier": 2,
"DBInstanceIdentifier": "sample-cluster-instance",
"PreferredBackupWindow": "00:00-00:30",
"PubliclyAccessible": false,
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"Subnets": [
{
"SubnetIdentifier": "subnet-4e26d263",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-afc329f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-53ab3636",
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-991cb8d0",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-29ab1025",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupDescription": "default",
"SubnetGroupStatus": "Complete"
},
"PendingModifiedValues": {},
"KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
}
]
}
```
------
# 修改 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)。
------
# 重启 Amazon DocumentDB 实例
有时您可能需要重启 Amazon DocumentDB 实例，这通常是出于维护原因。如果您进行了某些更改，例如更改与集群关联的集群参数组，则必须重启集群中的实例才能使更改生效。您可以使用 AWS 管理控制台 或重启指定的实例 AWS CLI。
重启实例会重新启动数据库引擎服务。重启将导致短暂中断，在此期间，实例的状态将设置为 `rebooting`。重新启动完成后，即会创建 Amazon DocumentDB 事件。
重启实例不会导致失效转移。要对 Amazon DocumentDB 集群进行故障转移，请使用 AWS 管理控制台 或操作。 AWS CLI `failover-db-cluster`有关更多信息，请参阅 [Amazon DocumentDB 失效转移](failover.md)。
如果实例未处于 *available (可用)* 状态，则无法重启该实例。数据库可能会由于几个原因而不可用，例如，以前请求的修改或维护时段操作。有关实例状态的更多信息，请参阅[监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS 管理控制台 ]
以下过程将使用控制台重启您指定的实例。
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 (操作)**、**Reboot (重启)**，然后选择 **Reboot (重启)** 以确认重启。
实例重启需要几分钟时间。只有在实例状态为 *available (可用)* 时，才能使用实例。您可以使用控制台或 AWS CLI监控实例状态。有关更多信息，请参阅 [监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
要重启 Amazon DocumentDB 实例，请使用具有 `--db-instance-identifier` 参数的 `reboot-db-instance` 操作。此参数指定要重启的实例的标识符。
以下代码将重启实例 `sample-instance`。
**Example**
对于 Linux、macOS 或 Unix：
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
对于 Windows：
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
此操作的输出将类似于下文。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "rebooting",
"Endpoint": {
"Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
实例重启需要几分钟时间。只有在实例状态为 *available (可用)* 时，才能使用实例。您可以使用控制台或 AWS CLI监控实例状态。有关更多信息，请参阅 [监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
# 删除 Amazon DocumentDB 实例
您可以使用 AWS 管理控制台 或删除您的 Amazon DocumentDB 实例。 AWS CLI要删除某个实例，该实例必须处于*可用* 状态。您无法删除已停止的实例。如果包含您的实例的 Amazon DocumentDB 集群已停止，则首先启动集群，等待实例进入*可用*状态，然后删除实例。有关更多信息，请参阅 [停止和启动 Amazon DocumentDB 集群](db-cluster-stop-start.md)。
**注意**
Amazon DocumentDB 将所有数据都存储在集群卷中。即使您从集群中删除所有实例，数据仍会保留在该集群卷中。如果您需要再次访问数据，则可随时向该集群中添加实例，并在停止处恢复操作。
------
#### [ 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 (操作)**，然后选择 **Delete (删除)**。
1. 如果您要删除集群中的最后一个实例：
+ **Create final cluster snapshot? (是否创建最终集群快照?)** — 如果要在删除集群之前创建最终快照，请选择** Yes (是)**。否则，请选择 **No**。
+ **Final snapshot name (最终快照名称)**：如果您选择创建最终快照，请输入所创建的新集群快照的集群快照标识符。
+ **Delete instance? (是否删除 实例?)** — 在此字段中输入** delete entire cluster (删除整个集群) **短语以确认删除。
1. 如果您不删除集群中的最后一个实例：
+ **Delete instance? (是否删除 实例?)** — 在此字段中输入** delete me (删除我)** 短语以确认删除。
1. 选择 **Delete (删除)** 以删除实例。
删除实例需要几分钟时间。要监控实例的状态，请参阅[监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
以下过程使用 AWS CLI删除 Amazon DocumentDB 实例。
1. **首先，确定您的 Amazon DocumentDB 集群中有多少个实例：**
要确定集群中有多少个实例，请运行 `describe-db-clusters` 命令，如下所示。
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
此操作的输出将类似于下文。
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **如果您的 Amazon DocumentDB 集群中有多个实例：**
要删除指定的 Amazon DocumentDB 实例，请使用带 `--db-instance-identifier` 参数的 `delete-db-instance` 命令，如下所示。删除实例需要几分钟时间。要监控实例的状态，请参阅[监控 Amazon DocumentDB 实例的状态](monitoring_docdb-instance_status.md)。
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
此操作的输出将类似于下文。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "deleting",
"Endpoint": {
"Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
1. **如果要删除的实例是 Amazon DocumentDB 集群中的最后一个实例：**
如果您删除 Amazon DocumentDB 集群中的最后一个实例，则还会删除该集群以及与该集群关联的自动快照和持续备份。
要删除集群中的最后一个实例，您可以删除此集群并可以选择创建最终快照。有关更多信息，请参阅 [删除 Amazon DocumentDB 集群](db-cluster-delete.md)。
------
## 删除保护
删除 Amazon DocumentDB 集群的最后一个实例也将删除该集群，以及与该集群关联的自动快照和连续备份。无论您使用还是执行删除操作，Amazon DocumentDB 都会对集群强制执行删除保护。 AWS 管理控制台 AWS CLI如果已启用删除保护，则无法删除集群。
要删除启用了删除保护的实例，首先请修改该集群并禁用删除保护。有关更多信息，请参阅 [删除 Amazon DocumentDB 集群](db-cluster-delete.md)。