

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 删除 Amazon DocumentDB 实例
<a name="db-instance-delete"></a>

您可以使用 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-name> instance? (是否删除 <instance-name> 实例?)** — 在此字段中输入** delete entire cluster (删除整个集群) **短语以确认删除。

   1. 如果您不删除集群中的最后一个实例：
      + **Delete <instance-name> instance? (是否删除 <instance-name> 实例?)** — 在此字段中输入** 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:<accountID>:key/sample-key",
           "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
           "CACertificateIdentifier": "rds-ca-2019",
           "PromotionTier": 1,
           "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance-2",
           "EnabledCloudwatchLogsExports": [
               "profiler"
           ]
       }
   }
   ```

1. **如果要删除的实例是 Amazon DocumentDB 集群中的最后一个实例：**

   如果您删除 Amazon DocumentDB 集群中的最后一个实例，则还会删除该集群以及与该集群关联的自动快照和持续备份。

   要删除集群中的最后一个实例，您可以删除此集群并可以选择创建最终快照。有关更多信息，请参阅 [删除 Amazon DocumentDB 集群](db-cluster-delete.md)。

------

## 删除保护
<a name="db-instance-delete-deletion-protection"></a>

删除 Amazon DocumentDB 集群的最后一个实例也将删除该集群，以及与该集群关联的自动快照和连续备份。无论您使用还是执行删除操作，Amazon DocumentDB 都会对集群强制执行删除保护。 AWS 管理控制台 AWS CLI如果已启用删除保护，则无法删除集群。

要删除启用了删除保护的实例，首先请修改该集群并禁用删除保护。有关更多信息，请参阅 [删除 Amazon DocumentDB 集群](db-cluster-delete.md)。