本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 管理 Amazon DocumentDB 弹性集群
要管理 Amazon DocumentDB 弹性集群，您必须拥有带适当 Amazon DocumentDB 控制层面的 IAM policy略。这些权限使您能够创建、修改和删除集群。亚马逊文档DBFull访问策略提供了管理亚马逊 DocumentDB 弹性集群所需的所有权限。
以下主题显示使用 Amazon DocumentDB 弹性集群时如何执行各种任务。
**Topics**
+ [修改弹性集群配置](#elastic-modify)
+ [监控弹性集群](#elastic-monitor)
+ [删除弹性集群](#elastic-delete)
+ [管理弹性集群快照](elastic-manage-snapshots.md)
+ [停止和启动 Amazon DocumentDB 弹性集群](elastic-cluster-stop-start.md)
+ [维护 Amazon DocumentDB 弹性集群](elastic-cluster-maintenance.md)
## 修改弹性集群配置
在本节中，我们将说明如何使用 AWS 管理控制台 或 AWS CLI 并按照以下说明修改弹性集群。
修改集群的主要用途是通过增加或减少分片计数 and/or 分片计算容量来扩展分片。
------
#### [ Using the AWS 管理控制台 ]
要使用以下命令修改弹性集群配置 AWS 管理控制台：
1. 登录 [AWS 管理控制台](https://console.aws.amazon.com/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。
1. 在导航窗格中，选择**集群**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
1. 在**集群标识符列**中选择您想要修改的集群的名称。
1. 选择 **Modify**(修改)。
1. 编辑您想要更改的字段，然后选择**修改群集**。
![\[表单，其中显示了可以修改的配置、维护、身份验证和网络设置等选项，“修改集群”按钮位于右下角。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/cluster-shard-modify-3.png)
**注意**
或者，您可以通过以下方式访问**修改集群**对话框：转到**集群**页面，勾选紧邻您集群的复选框，选择**操作**，然后选择**修改**。
------
#### [ Using the AWS CLI ]
要使用修改弹性集群配置 AWS CLI，请使用带有以下参数的`update-cluster`操作：
+ **--cluster-arn**：必填项。要删除的集群的 ARN 标识符。
+ **--shard-capacity**：可选。CPUs 分配给每个分片的 v 数。最大值为 64。允许值为 2、4、8、16、32、64。
+ **--shard-count**：可选。分配给集群的分片的数目。最大值为 32。
+ **--shard-instance**-count：可选。适用于此集群中所有分片的副本实例数量。最大值为 16。
+ **--auth-type**：可选。用于确定从何处获取用于访问弹性集群的密码的身份验证类型。有效类型为 `PLAIN_TEXT` 和 `SECRET_ARN`。
+ **--admin-user-password**：可选。与管理用户关联的密码。
+ **--vpc-security-group-ids**：可选。配置与这个集群待关联的一系列 Amazon EC2 安全组和 Amazon VPC (VPC) 安全组。
+ **--preferred-maintenance-window**：可选。配置可进行系统维护的每周时间范围（采用通用协调时间（UTC））
格式为：`ddd:hh24:mi-ddd:hh24:mi`。有效值 (ddd)：Mon、Tue、Wed、Thu、Fri、Sat、Sun
默认值为每个 Amazon Web Services 区域 8 小时的时间段中随机选择的 30 分钟时段（随机选取周中的某天进行）。
至少 30 分钟的窗口。
+ **--subnet-ids**：可选。配置网络子网 ID。
在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic update-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
--shard-capacity 8 \
--shard-count 4 \
--shard-instance-count 3 \
--admin-user-password testPassword \
--vpc-security-group-ids ec-65f40350 \
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
对于 Windows：
```
aws docdb-elastic update-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
--shard-capacity 8 ^
--shard-count 4 ^
--shard-instance-count 3 ^
--admin-user-password testPassword ^
--vpc-security-group-ids ec-65f40350 ^
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
------
要在修改后监控弹性集群的状态，请参阅监控弹性集群。
## 监控弹性集群
在本节中，我们将说明如何使用 AWS 管理控制台 或 AWS CLI 以及以下说明监控您的弹性集群。
------
#### [ Using the AWS 管理控制台 ]
要使用以下方法监控弹性集群配置 AWS 管理控制台：
1. 登录 [AWS 管理控制台](https://console.aws.amazon.com/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。
1. 在导航窗格中，选择**集群**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
1. 在**集群标识符**列中选择您想要监控的集群的名称。
1. 选择**监控**选项卡。
![\[弹性集群摘要信息显示在“监控”选项卡中。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/cluster-shard-monitor-2.png)
Amazon CloudWatch 为以下监控类别显示了许多图表：
+ 资源利用率
+ 吞吐量
+ 操作
+ 系统
您也可以 CloudWatch 通过访问 Amazon AWS 管理控制台 ，为您的弹性集群设置自己的监控环境。
------
#### [ Using the AWS CLI ]
要使用监控特定的弹性集群配置 AWS CLI，请使用带有以下参数的`get-cluster`操作：
+ **--cluster-arn**：必填项。要获取其信息的集群的 ARN 标识符。
在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic get-cluster \
--cluster-arn arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9
```
对于 Windows：
```
aws docdb-elastic get-cluster ^
--cluster-arn arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9
```
此操作的输出将类似于以下内容：
```
"cluster": {
...
"clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9",
"clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com",
"readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com",
"clusterName": "stretch-11",
"shardCapacity": 2,
"shardCount": 3,
"shardInstanceCount: 5,
"status": "ACTIVE",
...
}
```
有关更多信息，请参阅 Amazon DocumentDB 资源管理 API 参考中的 `DescribeClusterSnapshot`。
要使用查看所有弹性集群的详细信息 AWS CLI，请使用带有以下参数的`list-clusters`操作：
+ **--next-token**：可选。如果项目输出的数量（`--max-results`）少于基础 API 调用所返回的项目总数，则输出将包含您可传递到后续命令的 `NextToken` 以检索下一组项目。
+ **--max-results**：可选。命令的输出中要返回的项目总数。如果存在的记录数超过了指定的`max-results` 值，则在响应中包含分页记号（`next-token`），以便检索剩余的结果。
+ 默认值：100
+ 最小值 20，最大值 100
在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic list-clusters \
--next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== \
--max-results 2
```
对于 Windows：
```
aws docdb-elastic list-clusters ^
--next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== ^
--max-results 2
```
此操作的输出将类似于以下内容：
```
{
"Clusters": [
{
"ClusterIdentifier":"mycluster-1",
"ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
{
"ClusterIdentifier":"mycluster-2",
"ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
]
}
```
------
## 删除弹性集群
在本节中，我们将说明如何使用 AWS 管理控制台 或 AWS CLI 以及以下说明删除弹性集群。
------
#### [ Using the AWS 管理控制台 ]
要使用 AWS 管理控制台删除弹性集群配置：
1. 登录 [AWS 管理控制台](https://console.aws.amazon.com/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。
1. 在导航窗格中，选择**集群**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
1. 在集群列表表中，选择在您想要删除的集群名称左侧的复选框，然后选择**操作**。从下拉菜单中，选择**删除**。
1. 在**是否删除“集群名称” 弹性集群？**对话框中，选择**删除**。
![\[“删除”对话框，“删除”按钮位于右下角。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/cluster-delete-dialog.png)
删除集群需要几分钟时间。要监控集群的状态，请参阅 [ 监控 Amazon DocumentDB 集群的状态](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html)。
------
#### [ Using the AWS CLI ]
要使用删除弹性集群 AWS CLI，请使用带有以下参数的`delete-cluster`操作：:
+ **--cluster-arn**：必填项。要删除的集群的 ARN 标识符。
+ **--no-skip-final-backup**：可选。如果您需要最终备份，则必须包含该参数和最终备份的名称。必须包含 `--final-backup-identifier` 或 `--skip-final-backup`。
+ **--skip-final-backup**：可选。仅当您不想在删除集群之前拍摄最终备份时，才使用此参数。默认设置是拍摄最终快照。
以下 AWS CLI 代码示例删除 ARN 为 arn: aws: docdb: us-west-2:123456789012: sharded-cluster: sample-cluster 的集群，并进行最终备份。
在以下示例中，用您自己的信息替换每个*user input placeholder*示例。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic delete-cluster \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
--no-skip-final-backup \
--final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
对于 Windows：
```
aws docdb-elastic delete-cluster ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
--no-skip-final-backup ^
--final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
以下 AWS CLI 代码示例在不进行最终备份的情况下删除 ARN 为 arn: aws: docdb: us-west-2:123456789012: sharded-cluster: sample-cluster 的集群。
在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic delete-cluster \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
--skip-final-backup \
```
对于 Windows：
```
aws docdb-elastic delete-cluster ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
--skip-final-backup ^
```
`delete-cluster` 操作的输出是您要删除的集群的展示。
删除集群需要几分钟时间。要监控集群的状态，请参阅 [ 监控 Amazon DocumentDB 集群的状态](https://docs.aws.amazon.com/documentdb/latest/developerguide/monitoring_docdb-cluster_status.html)。
------
# 管理弹性集群快照
已经创建弹性集群后可以手动拍摄快照。在创建弹性集群快照的那一刻就会创建自动备份。
**注意**
您的集群必须处于 `Available` 状态，才能拍摄手动快照。
这个部分解释如何创建、查看、恢复和删除弹性集群快照。
以下主题显示使用 Amazon DocumentDB 弹性集群快照时如何执行各种任务。
**Topics**
+ [创建手动弹性集群快照](#elastic-create-snapshot)
+ [查看弹性集群快照](#elastic-view-snapshot)
+ [从快照还原弹性集群](#elastic-restore-snapshot)
+ [复制弹性集群快照](#elastic-copy-snapshot)
+ [删除弹性集群快照](#elastic-delete-snapshot)
+ [管理弹性集群快照的自动备份](#elastic-auto-snapshot)
## 创建手动弹性集群快照
在本节中，我们将说明如何使用 AWS 管理控制台 或 AWS CLI 以及以下说明创建手动弹性集群快照。
------
#### [ Using the AWS 管理控制台 ]
要使用 AWS 管理控制台创建手动弹性集群快照：
1. 登录 [AWS 管理控制台](https://console.aws.amazon.com/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。
1. 在导航窗格中，选择**快照**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
1. 在 **Snapshots (快照)** 页面上，选择 **Create (创建)**。
1. 在**创建集群快照**页面上**集群标识符**字段中，从下拉列表选择您的弹性集群。
在**快照标识符**字段中，输入您弹性集群的唯一标识符。
选择**创建**。
![\[图：弹性集群创建快照\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/elastic-create-snapshot.png)
**注意**
或者，您可以通过以下方式访问**创建集群快照**对话框：转到**集群**页面，勾选紧邻您集群的复选框，然后选择**操作**，然后**拍摄快照**。
您的弹性集群快照现正在预配置。此过程可能需要数分钟完成。当状态作为 `Available` 在**快照**列表中显示时，您可以查看快照并从其中恢复。
------
#### [ Using the AWS CLI ]
要使用创建手动弹性集群快照 AWS CLI，请使用带有以下参数的`create-cluster-snapshot`操作：
+ **--snapshot-name**：必填项。用来创建新集群的快照的名称。
+ **--cluster-arn**：必填项。您想要创建其快照的集群的 ARN 标识符。
在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic create-cluster-snapshot \
--snapshot-name sample-snapshot-1 \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
对于 Windows：
```
aws docdb-elastic create-cluster-snapshot ^
--snapshot-name sample-snapshot-1 ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
------
## 查看弹性集群快照
在本节中，我们将说明如何使用 AWS 管理控制台 或 AWS CLI 以及以下说明查看弹性集群快照信息。
------
#### [ Using the AWS 管理控制台 ]
要查看有关特定弹性集群快照的信息，请使用 AWS 管理控制台：
1. 登录 [AWS 管理控制台](https://console.aws.amazon.com/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。
1. 在导航窗格中，选择**快照**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
1. 在**快照**页面上，通过点击**快照标识符**列中的名称，从列表选择您的快照。
1. 在**详情**中查看您的快照信息。
![\[图：弹性集群视图快照\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/elastic-snapshot-view.png)
------
#### [ Using the AWS CLI ]
要使用查看有关特定弹性集群快照的信息 AWS CLI，请使用带有以下参数的`get-cluster-snapshot`操作：
+ **--snapshot-arn**：必填项。您要获取其信息的快照的 ARN 标识符。
在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic get-cluster-snapshot \
--snapshot-arn sampleResourceName
```
对于 Windows：
```
aws docdb-elastic get-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
要使用查看有关特定弹性集群快照的信息 AWS CLI，请使用带有以下参数的`get-cluster-snapshot`操作：
+ **--snapshot-arn**：必填项。您要获取其信息的快照的 ARN 标识符。
在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic get-cluster-snapshot \
--snapshot-arn sampleResourceName
```
对于 Windows：
```
aws docdb-elastic get-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
要使用查看有关所有弹性集群快照的信息 AWS CLI，请使用带有以下参数的`list-cluster-snapshots`操作：
+ **--snapshot-type**—可选。要返回的数据库集群快照的类型。可以指定以下值之一：
+ `automated`-返回 Amazon DocumentDB 自动为您的 AWS 账户创建的所有集群快照。
+ `manual`-返回您为 AWS 账户手动创建的所有集群快照。
+ `shared`-返回已共享到您的 AWS 账户的所有手动集群快照。
+ `public`：返回已标记为公有的所有集群快照。
+ **--next-token**：可选。由之前的请求提供的可选分页标记。如果指定此参数，则响应仅包含令牌之外的记录，最大数量为 `max-results` 指定的值。
+ **--max-results**：可选。包括在响应中的最大记录数。如果存在的记录数超过了指定的`max-results` 值，则在响应中包含分页记号（`next-token`），以便检索剩余的结果。
+ 默认值：100
+ 最小值 20，最大值 100
在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic list-cluster-snapshots \
--snapshot-type value \
--next-token value \
--max-results 50
```
对于 Windows：
```
aws docdb-elastic list-cluster-snapshots ^
--snapshot-type value ^
--next-token value ^
--max-results 50
```
------
## 从快照还原弹性集群
在本节中，我们将按照以下说明说明如何使用 AWS 管理控制台 或 AWS CLI 从快照恢复弹性集群。
------
#### [ Using the AWS 管理控制台 ]
使用 AWS 管理控制台从快照还原弹性集群：
1. 登录 [AWS 管理控制台](https://console.aws.amazon.com/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。
1. 在导航窗格中，选择**快照**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
1. 在**快照标识符** 中，选择要用于还原集群的快照左侧的按钮。
1. 选择**操作**，然后**还原**。
![\[图：从快照恢复弹性集群\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/elastic-restore-snapshot.png)
1. 在**还原快照**页面上，在**集群标识符**字段中输入新集群的名称。
**注意**
对于任何手动快照恢复，您必须创建一个新集群。
1. 在**虚拟私有云 (VPC)**字段中，从下拉列表中选择一个 VPC。
1. 对于**子网**和 **VPC 安全组**，您可以使用默认值或选择您选定的三个子网和多达三个 VPC 安全组（最少一个）。
1. 如果您对集群配置满意，请选择 **Restore cluster (还原集群)** 并等待集群还原。
------
#### [ Using the AWS CLI ]
要使用从快照恢复弹性集群 AWS CLI，请使用带有以下参数的`restore-cluster-from-snapshot`操作：
+ **--cluster-name**：必填项。创建期间输入或上次修改的弹性集群的当前名称。
+ **--snapshot-arn**：必填项。正用于恢复集群的快照的 ARN 标识符。
+ **--vpc-security-group-ids**：可选。与该集群待关联的一个或多个 Amazon EC2 安全组和 Amazon VPC (VPC) 安全组。
+ **--kms-key-id**：可选。配置已加密集群的 KMS 密钥标识符。
KMS 密钥标识符是 AWS KMS 加密密钥的亚马逊资源名称 (ARN)。如果使用拥有用于加密新集群的 KMS 加密密钥的同一 Amazon Web Services 账户创建集群，则可以使用 KMS 密钥别名而不是 KMS 加密密钥的 ARN。
如果中未指定加密密钥， KmsKeyId 且`StorageEncrypted`参数为真，则 Amazon DocumentDB 将使用您的默认加密密钥。
+ **--subnet-ids**—可选。网络子网 ID。
在以下示例中，用您自己的信息替换每个*user input placeholder*示例。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic restore-cluster-from-snapshot \
--cluster-name elastic-sample-cluster \
--snapshot-arn sampleResourceName \
--vpc-security-group-ids value ec-65f40350 \
--kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
对于 Windows：
```
aws docdb-elastic restore-cluster-from-snapshot ^
--cluster-name elastic-sample-cluster ^
--snapshot-arn sampleResourceName ^
--vpc-security-group-ids value ec-65f40350 ^
--kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
------
## 复制弹性集群快照
在 Amazon DocumentDB 中，您可以在同一区域和同一账户中复制手动和自动弹性集群快照。在本节中，我们将说明如何使用 AWS 管理控制台 或复制弹性集群快照 AWS CLI。
------
#### [ Using the AWS 管理控制台 ]
要使用以下方法复制弹性集群快照 AWS 管理控制台：
1. 登录 [AWS 管理控制台](https://console.aws.amazon.com/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。
1. 在导航窗格中，选择**快照**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
1. 在**快照标识符**中，选择要复制的快照左侧的按钮。
1. 选择**操作**和**复制**。
![\[图：弹性集群复制快照\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/ec-copy-snapshot.png)
1. 对于**新快照标识符**，输入新快照的名称。
1. 对于**复制标签**，如果要将源弹性集群快照的所有标签复制到目标弹性集群快照，请勾选此方框。
1. 对于**加密**，请选择默认 AWS KMS 密钥或 KMS 密钥。在第二个选项中，您可以选择已创建的现有 KMS 密钥，也可以创建新的密钥。
1. 完成后选择**复制快照**。
------
#### [ Using the AWS CLI ]
要使用复制弹性集群快照 AWS CLI，请使用带有以下参数的`copy-cluster-snapshot`操作：
+ **‐‐source-db-cluster-snapshot-identifier**：必填项。当前复制的现有弹性集群快照的标识符。弹性集群快照必须存在并且处于可用状态。此参数不区分大小写。
+ **‐‐target-db-cluster-snapshot-identifier**：必填项。要从现有集群快照创建的新弹性集群快照标识符。此参数不区分大小写。
目标快照名称约束：
+ 不能是现有快照的名称。
+ 长度为 [1-63] 个字母、数字或连字符。
+ 第一个字符必须是字母。
+ 不能以连字符结尾或包含两个连续的连字符。
在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic copy-cluster-snapshot \
‐‐source-cluster-snapshot-arn \
‐‐target-cluster-snapshot-name my-target-copied-snapshot
```
对于 Windows：
```
aws docdb-elastic copy-cluster-snapshot ^
‐‐source-cluster-snapshot-arn ^
‐‐target-cluster-snapshot-name my-target-copied-snapshot
```
------
## 删除弹性集群快照
在本节中，我们将说明如何使用 AWS 管理控制台 或删除弹性集群快照 AWS CLI。
------
#### [ Using the AWS 管理控制台 ]
使用 AWS 管理控制台从快照还原弹性集群：
1. 登录 [AWS 管理控制台](https://console.aws.amazon.com/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。
1. 在导航窗格中，选择**快照**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
1. 在**快照标识符** 中，选择要用于还原集群的快照左侧的按钮。
1. 选择**操作**，然后选择**删除**。
![\[图：弹性集群删除快照\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/elastic-delete-snapshot.png)
1. 在**删除“快照名称”快照**对话框中，选择**删除**。
------
#### [ Using the AWS CLI ]
要使用删除弹性集群快照 AWS CLI，请使用带有以下参数的`delete-cluster-snapshot`操作：
+ **--snapshot-arn**：必填项。正用于恢复集群的快照的 ARN 标识符。
在以下示例中，用您自己的信息替换每个*user input placeholder*示例。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic delete-cluster-snapshot \
--snapshot-arn sampleResourceName
```
对于 Windows：
```
aws docdb-elastic delete-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
------
## 管理弹性集群快照的自动备份
Amazon DocumentDB 每天都会对弹性集群拍摄快照。您可以在新的或现有弹性集群快照配置中，指定首选备份时段和备份保留期。在本节中，我们将说明如何使用 AWS 管理控制台 或在弹性集群快照中设置自动备份参数 AWS CLI。
------
#### [ Using the AWS 管理控制台 ]
要为新的弹性集群快照设置自动备份，请使用 AWS 管理控制台：
1. 登录 [AWS 管理控制台](https://console.aws.amazon.com/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。
1. 在导航窗格中，选择**集群**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
1. 在**集群标识符**中，选择要更改其备份设置的集群左侧的按钮。
1. 依次选择**操作**和**修改**。
1. 在**备份**部分，根据您的备份要求编辑字段。
![\[显示用于配置集群备份时段的步骤的“Backup (备份)”窗格屏幕截图。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/ec-backup.png)
1. **备份留存期**：在列表中，选择在删除此集群的自动备份前保留它们的天数。
1. **备份时段**：设置 Amazon DocumentDB 要备份此集群的每日时间和持续时间。
1. 如果要配置创建备份的时间和时长，请选择**选择时段**。
**开始时间**：在第一个列表中，选择开始自动备份的开始时间小时 (UTC)。在第二个列表中，选择您希望自动备份开始的时间（分钟）。
**持续时间**：在该列表中，选择要向创建自动备份分配的小时数。
1. 如果想要 Amazon DocumentDB 选择创建备份的时间和时长，请选择**无首选项**。
1. 完成后选择**修改集群**。
------
#### [ Using the AWS CLI ]
要使用为新的弹性集群快照设置自动备份 AWS CLI，请使用带有以下参数的`create-cluster-snapshot`操作：
+ **--preferred-backup-window**：可选。创建自动备份的每日首选时间范围。默认值是从 8 小时的时间段中随机选择一个 30 分钟的窗口。 AWS 区域
约束：
+ 必须采用 `hh24:mi-hh24:mi` 格式。
+ 必须采用通用协调时间（UTC）。
+ 不得与首选维护时段冲突。
+ 必须至少为 30 分钟。
+ **--backup-retention-period**：可选。自动备份的保留天数。默认值是 1。
约束：
+ 必须指定最小值 1。
+ 范围从 1 到 35。
**注意**
只有当集群处于“活动”状态时才进行自动备份。
**注意**
您也可以使用 `aws docdb-elastic update-cluster` 命令修改现有弹性集群的 `preferred-backup-window` 和 `backup-retention-period` 参数。
在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。
以下`create-cluster`示例创建了 Amazon DocumentDB 弹性集群*sample-cluster*，自动备份的保留期为*7*几天，首选备份窗口为。*18:00-18:30 UTC*
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic create-cluster \
--cluster-name sample-cluster \
--shard-capacity 2 \
--shard-count 2 \
--admin-user-name SampleAdmin \
--auth-type PLAIN_TEXT \
--admin-user-password SamplePass123! \
--preferred-backup-window 18:00-18:30 \
--backup-retention-period 7
```
对于 Windows：
```
aws docdb-elastic create-cluster ^
--cluster-name sample-cluster ^
--shard-capacity 2 ^
--shard-count 2 ^
--admin-user-name SampleAdmin ^
--auth-type PLAIN_TEXT ^
--admin-user-password SamplePass123! ^
--preferred-backup-window 18:00-18:30 ^
--backup-retention-period 7
```
------
# 停止和启动 Amazon DocumentDB 弹性集群
停止和启动 Amazon DocumentDB 弹性集群可以帮助您控制开发和测试环境的成本。当不需要时，您可以暂时停止弹性集群，而不是在每次使用 Amazon DocumentDB 时创建和删除集群。当您恢复测试时，可以再次启动。
**Topics**
+ [停止和启动弹性集群概述](#elastic-cluster-stop-start-overview)
+ [可以在已停止的弹性集群上执行的操作](#elastic-cluster-stopped-operations)
## 停止和启动弹性集群概述
在不需要使用 Amazon DocumentDB 弹性集群期间，您可以停止该集群。然后，您可以在需要使用时再次启动集群。启动和停止简化了用于开发、测试或不需要持续可用性的类似活动的弹性集群的设置和停用过程。您可以使用 AWS 管理控制台 或通过单个操作停止和启动弹性集群。 AWS CLI
当您的弹性集群停止后，集群存储卷保持不变。您只需在指定的保留时段内为集群存储、手动快照和自动备份存储付费。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. 在集群列表中，选择要停止或启动的集群名称左侧的按钮。
![\[集群列表中的集群，集群名称左侧的复选框处于选中状态。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/cluster-list-ec.png)
1. 选择**操作**，然后选择您要在集群上执行的操作。
+ 如果您要停止集群且集群可用，则：
1. 选择**停止**。
![\[“操作”下拉列表，其中已选择“停止”选项。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/ec-stop.png)
1. 在确认对话框中，确认您要通过选择**停止集群**来停止该弹性集群；或者要保持集群运行，则选择**取消**。
![\[用于停止集群的确认对话框，“取消”和“停止集群”按钮位于底部。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/ec-stop-confirm.png)
+ 如果您要启动集群且集群处于停止状态，则选择**启动**。
![\[“操作”下拉列表，其中已选择“启动”选项。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/ec-start.png)
1. 监控弹性集群的状态。如果您启动集群，则当集群*可用*时，您可以继续使用集群。有关更多信息，请参阅 [确定集群的状态](db-cluster-status.md)。
![\[“集群”表中的“状态”列，其中显示了可用状态和正在启动状态。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/ec-starting-status.png)
------
#### [ Using the AWS CLI ]
以下代码示例显示如何停止处于活动或可用状态的弹性集群或启动已停止的弹性集群。
要使用停止弹性集群 AWS CLI，请使用`stop-cluster`操作。要启动已停止的集群，请使用 `start-cluster` 操作。这两个操作都使用 `--cluster-arn` 参数。
**参数：**
+ **--cluster-arn**：必填项。要停止或启动的弹性集群的 ARN 标识符。
**Example — 要停止弹性集群，请使用 AWS CLI**
在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。
以下代码可停止 ARN 为 `arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2` 的弹性集群。
弹性集群必须为活动或可用状态。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic stop-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
对于 Windows：
```
aws docdb-elastic stop-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
**Example — 要启动弹性集群，请使用 AWS CLI**
在以下示例中，将每个 *user input placeholder* 替换为您自己的信息。
以下代码可启动 ARN 为 `arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2` 的弹性集群。
弹性集群必须处于停止状态。
对于 Linux、macOS 或 Unix：
```
aws docdb-elastic start-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
对于 Windows：
```
aws docdb-elastic start-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
------
## 可以在已停止的弹性集群上执行的操作
在 Amazon DocumentDB 弹性集群停止后，您无法修改该集群的配置。您必须在执行任何此类管理操作之前启动该集群。
仅当再次启动后， Amazon DocumentDB 才会将任何计划的维护应用于停止的弹性集群。七天后，Amazon DocumentDB 自动启动停止的弹性集群，以使其维护状态不会落后太多。当弹性集群重新启动后，您将再次开始为集群中的分片付费。
弹性集群停止后，Amazon DocumentDB 不会执行任何自动备份，也不会延长备份留存期。
# 维护 Amazon DocumentDB 弹性集群
**Topics**
+ [查看待处理的弹性集群维护操作](#view-elastic-cluster-maintenance)
+ [弹性集群引擎更新](#elastic-cluster-engine-updates)
+ [弹性集群操作系统更新](#elastic-cluster-os-updates)
Amazon DocumentDB 会定期对 Amazon DocumentDB 弹性集群资源执行维护。维护最常涉及对数据库引擎（弹性集群维护）或弹性集群的底层操作系统的更新（操作系统更新）。数据库引擎更新是必需的补丁，包括安全补丁、错误修复以及数据库引擎增强功能。虽然大多数操作系统补丁都是可选的，但如果在一段时间内未应用这些补丁，就可能变成必需补丁并自动应用，以保持您的安全状况。因此，我们建议在操作系统更新可用时立即将其应用于 Amazon DocumentDB 弹性集群。
数据库引擎补丁需要使 Amazon DocumentDB 弹性集群脱机一小段时间。一旦这些补丁可用后，系统会自动安排在即将到来的 Amazon DocumentDB 弹性集群计划维护时段内应用补丁。
弹性集群有各自的维护时段。您选择不立即应用的弹性集群修改会在维护时段内应用。默认情况下，在创建弹性集群时，Amazon DocumentDB 会为弹性集群分配维护时段。您可以在创建弹性集群时选择维护时段。也可以随时修改维护时段以适应您的业务计划或实践。通常，建议选择尽量减少对应用程序的影响的维护时段（例如，晚上或周末）。
## 查看待处理的弹性集群维护操作
您可以使用 AWS CLI来查看维护更新是否对弹性集群可用。
如果有可用更新，您可以执行以下操作之一：
+ 推迟目前计划在下一个维护窗口内执行的维护操作（仅适用于操作系统补丁）。
+ 立即应用维护操作。
+ 计划下一个维护时段内要开始的维护操作。
+ 计划所选应用时段内要开始的维护操作。
维护时段确定待处理的操作何时开始，但不限制这些操作的总执行时间。
使用以下 AWS CLI 操作来确定哪些维护操作处于待处理状态。列出所有待处理的维护操作：
```
aws docdb-elastic list-pending-maintenance-actions
```
此操作的输出将类似如下（JSON 格式）：
```
{
'ResourcePendingMaintenanceActions': [
{
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'ENGINE_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'string',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
},
],
'NextToken': 'string'
}
```
获取给定 `resourceArn` 的待处理维护操作（如果有）：
```
aws docdb-elastic get-pending-maintenance-action --resource-arn string-arn
```
此操作的输出将类似于下文（JSON 格式）。
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'ENGINE_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'string',
'CurrentApplyDate': 'string',
'Description': 'string'
}
]
}
}
```
参数：
+ `ResourceArn`：待处理的维护操作应用于的资源的 Amazon DocumentDB Amazon 资源名称（ARN）。
+ `Action`：将应用于资源的待处理维护操作。
有效值：
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ `AutoAppliedAfterDate`：此日期之后的第一个维护时段。在此情况下将忽略 `NEXT_MAINTENANCE OPT_IN`。
+ `ForcedApplyDate`：无论维护时段如何都应用。在此情况下将忽略 `IMMEDIATE OPT_IN`。
+ `OptInStatus`：用于指定加入请求类型或撤消加入请求的值。不能撤消 `IMMEDIATE` 类型的加入请求。
有效值：
+ `IMMEDIATE`：立即应用维护操作。
+ `NEXT_MAINTENANCE`：在资源的下一个维护时段内应用维护操作。
+ `APPLY_ON`：在指定的应用日期应用维护操作，而无论资源的下一个维护时段如何。
+ `UNDO_OPT_IN`：取消任何现有的 `NEXT_MAINTENANCE` 或 `APPLY_ON` 选择加入请求。
+ `CurrentApplyDate`— 如果 opt-in-type是`APPLY_ON`，则显示。
+ `Description`：维护操作的选项描述。
## 弹性集群引擎更新
通过 Amazon DocumentDB，您可以选择何时应用维护操作。使用 AWS CLI时，您可以决定 Amazon DocumentDB 何时应用更新。
应用待处理的维护操作：
```
aws docdb-elastic apply-pending-maintenance-action
--resource-arn string-arn
--apply-action string-enum
--opt-in-type string-enum
[--apply-on string-date-range]
```
参数：
+ **--resource-arn**：待处理的维护操作应用于的资源的 Amazon DocumentDB Amazon 资源名称（ARN）。
+ **--apply-action**：应用于此资源的待处理的维护操作。
有效值：
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ **--opt-in-type**：用于指定加入请求类型或撤消加入请求的值。不能撤消 `IMMEDIATE` 类型的加入请求。
有效值：
+ `IMMEDIATE`：立即应用维护操作。
+ `NEXT_MAINTENANCE`：在资源的下一个维护时段内应用维护操作。
+ `APPLY_ON`：在指定的应用日期应用维护操作，而无论资源的下一个维护时段如何。
+ `UNDO_OPT_IN`：取消任何现有的 `NEXT_MAINTENANCE` 或 `APPLY_ON` 选择加入请求。
+ **[--apply-on]**：如果 opt-in-type 为 `APPLY_ON`，则为必需项。格式：`yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm`（此选项使用 UTC 时间。 开始时间可以是将来的任何时间，最少 30 分钟，最多 14 天，也可以是待处理操作的 force/apply 日期，以较早者为准。 开始到结束的时间范围可以是最少 30 分钟，最长可以是 8 小时。）
此操作的输出将类似如下（JSON 格式）：
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'SECURITY_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'IMMEDIATE',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
}
}
```
参数：
+ `ResourceArn`：待处理的维护操作应用于的资源的 Amazon DocumentDB Amazon 资源名称（ARN）。
+ `Action`：将应用于资源的待处理维护操作。
有效值：
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ `AutoAppliedAfterDate`：此日期之后的第一个维护时段。在此情况下将忽略 `NEXT_MAINTENANCE OPT_IN`。
+ `ForcedApplyDate`：无论维护时段如何都应用。在此情况下将忽略 `IMMEDIATE OPT_IN`。
+ `OptInStatus`：用于指定加入请求类型或撤消加入请求的值。不能撤消 `IMMEDIATE` 类型的加入请求。
有效值：
+ `IMMEDIATE`：立即应用维护操作。
+ `NEXT_MAINTENANCE`：在资源的下一个维护时段内应用维护操作。
+ `APPLY_ON`：在指定的应用日期应用维护操作，而无论资源的下一个维护时段如何。
+ `UNDO_OPT_IN`：取消任何现有的 `NEXT_MAINTENANCE` 或 `APPLY_ON` 选择加入请求。
+ `CurrentApplyDate`— 如果 opt-in-type是`APPLY_ON`，则显示。
+ `Description`：维护操作的选项描述。
### 应用日期
每个维护操作都有一个相应的应用日期，您可以在描述待处理的维护操作时找到它们。当您阅读中待处理的维护操作的输出时 AWS CLI，会列出三个日期：
+ `CurrentApplyDate`：将立即应用或在下一个维护时段期间应用维护操作的日期。如果维护是可选的，则该值可以为 null。
+ `ForcedApplyDate`：自动应用维护的日期，与维护时段无关。
+ `AutoAppliedAfterDate`：将在该日期后的集群维护时段期间应用维护。
### 用户创建的维护操作
作为 Amazon Doc DBelastic ument 集群用户，您可以启动对集群配置的更新。
**更新集群主密码**
```
aws docdb-elastic update-cluster
--cluster-arn string-arn
[--admin-user-password string]
[--auth-type string-enum]
[--apply-method string-enum]
[--apply-on string-date-range]
#... other parameters of the API that follow here are not relevant for this configuration
```
参数：
+ **--cluster-arn**：维护操作将应用于的资源的 Amazon DocumentDB Amazon 资源名称（ARN）。
+ **[--admin-user-password]**：与管理员用户关联的密码。
+ **[--auth-type]**：身份验证类型，用于确定从何处获取用于访问弹性集群的密码。有效类型为 `PLAIN_TEXT` 和 `SECRET_ARN`。
+ **[--apply-method]**：一个值，指定所应用方法的类型。支持的值包括 `IMMEDIATE` 和 `APPLY_ON`。默认值为 `IMMEDIATE`。
+ **[--apply-on]**：如果 `apply-method` 为 `APPLY_ON`，则为必需项。格式：`yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm`（此选项使用 UTC 时间。开始时间可以是未来的任何时间，最小值为 30 分钟，最大值为 14 天。开始到结束的时段可以最少为 30 分钟，最长为 8 小时。）
此操作的输出将类似如下（JSON 格式）：
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'MASTER_USER_PASSWORD_UPDATE',
'OptInStatus': 'APPLY_ON',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
}
}
```
### 更改您的 Amazon DocumentDB 维护窗口
维护时段应当选在使用量最小的时段上，因而可能必须不时予以更改。您的弹性集群只会在应用系统更改（例如，扩展存储操作更改）并且需要中断的期间出现不可用现象，且持续时间只是这些必要更改所需的最少时间。
默认值为每个 Amazon Web Services 区域 8 小时的时间段中随机选择的 30 分钟时段（随机选取周中的某天进行）。
要更改维护时段，请参阅 [修改弹性集群配置](elastic-managing.md#elastic-modify)。
## 弹性集群操作系统更新
Amazon DocumentDB 弹性集群偶尔需要操作系统更新。Amazon DocumentDB 将操作系统升级到更新的版本，以提高数据库性能和客户的整体安保状况。操作系统更新不会更改 Amazon DocumentDB 弹性集群的集群引擎版本。
Amazon DocumentDB 弹性集群的大多数操作系统更新都是可选的，没有固定的应用日期。但是，如果在一段时间内未应用这些更新，最终可能会变成必需的更新，并在集群维护时段内自动应用。这是为了帮助维持数据库的安全状况。为避免任何意外停机，我们建议在操作系统更新可用时，尽快将其应用于 Amazon DocumentDB 弹性集群，并根据业务需求在方便的时间设置集群维护时段。