本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 管理 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)
## 修改弹性集群配置
在本节中，我们将说明如何使用 Amazon Web Services 管理控制台 或 Amazon CLI 并按照以下说明修改弹性集群。
修改集群的主要用途是通过增加或减少分片计数 and/or 分片计算容量来扩展分片。
------
#### [ Using the Amazon Web Services 管理控制台 ]
要使用以下命令修改弹性集群配置 Amazon Web Services 管理控制台：
1. 登录 [Amazon Web Services 管理控制台](https://console.amazonaws.cn/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。
1. 在导航窗格中，选择**集群**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
1. 在**集群标识符列**中选择您想要修改的集群的名称。
1. 选择 **Modify**(修改)。
1. 编辑您想要更改的字段，然后选择**修改群集**。
![\[表单，其中显示了可以修改的配置、维护、身份验证和网络设置等选项，“修改集群”按钮位于右下角。\]](http://docs.amazonaws.cn/documentdb/latest/developerguide/images/cluster-shard-modify-3.png)
**注意**
或者，您可以通过以下方式访问**修改集群**对话框：转到**集群**页面，勾选紧邻您集群的复选框，选择**操作**，然后选择**修改**。
------
#### [ Using the Amazon CLI ]
要使用修改弹性集群配置 Amazon 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
```
------
要在修改后监控弹性集群的状态，请参阅监控弹性集群。
## 监控弹性集群
在本节中，我们将说明如何使用 Amazon Web Services 管理控制台 或 Amazon CLI 以及以下说明监控您的弹性集群。
------
#### [ Using the Amazon Web Services 管理控制台 ]
要使用以下方法监控弹性集群配置 Amazon Web Services 管理控制台：
1. 登录 [Amazon Web Services 管理控制台](https://console.amazonaws.cn/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。
1. 在导航窗格中，选择**集群**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
1. 在**集群标识符**列中选择您想要监控的集群的名称。
1. 选择**监控**选项卡。
![\[弹性集群摘要信息显示在“监控”选项卡中。\]](http://docs.amazonaws.cn/documentdb/latest/developerguide/images/cluster-shard-monitor-2.png)
Amazon CloudWatch 为以下监控类别显示了许多图表：
+ 资源利用率
+ 吞吐量
+ 操作
+ 系统
您也可以 CloudWatch 通过访问 Amazon Amazon Web Services 管理控制台 ，为您的弹性集群设置自己的监控环境。
------
#### [ Using the Amazon CLI ]
要使用监控特定的弹性集群配置 Amazon 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`。
要使用查看所有弹性集群的详细信息 Amazon 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"
}
]
}
```
------
## 删除弹性集群
在本节中，我们将说明如何使用 Amazon Web Services 管理控制台 或 Amazon CLI 以及以下说明删除弹性集群。
------
#### [ Using the Amazon Web Services 管理控制台 ]
要使用 Amazon Web Services 管理控制台删除弹性集群配置：
1. 登录 [Amazon Web Services 管理控制台](https://console.amazonaws.cn/docdb/home?region=us-east-1) 并打开 Amazon DocumentDB 控制台。
1. 在导航窗格中，选择**集群**。
**提示**
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
1. 在集群列表表中，选择在您想要删除的集群名称左侧的复选框，然后选择**操作**。从下拉菜单中，选择**删除**。
1. 在**是否删除“集群名称” 弹性集群？**对话框中，选择**删除**。
![\[“删除”对话框，“删除”按钮位于右下角。\]](http://docs.amazonaws.cn/documentdb/latest/developerguide/images/cluster-delete-dialog.png)
删除集群需要几分钟时间。要监控集群的状态，请参阅 [ 监控 Amazon DocumentDB 集群的状态](https://docs.amazonaws.cn//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html)。
------
#### [ Using the Amazon CLI ]
要使用删除弹性集群 Amazon CLI，请使用带有以下参数的`delete-cluster`操作：:
+ **--cluster-arn**：必填项。要删除的集群的 ARN 标识符。
+ **--no-skip-final-backup**：可选。如果您需要最终备份，则必须包含该参数和最终备份的名称。必须包含 `--final-backup-identifier` 或 `--skip-final-backup`。
+ **--skip-final-backup**：可选。仅当您不想在删除集群之前拍摄最终备份时，才使用此参数。默认设置是拍摄最终快照。
以下 Amazon 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
```
以下 Amazon 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.amazonaws.cn/documentdb/latest/developerguide/monitoring_docdb-cluster_status.html)。
------