管理弹性集群

要管理 Amazon DocumentDB 弹性集群，您必须拥有带适当 Amazon DocumentDB 控制层面的 IAM policy略。这些权限使您能够创建、修改和删除集群。Amazon DocumentDBFullAccess 策略提供管理 Amazon DocumentDB 集群所需的所有权限。

以下主题显示使用 Amazon DocumentDB 弹性集群时如何执行各种任务。

主题

修改弹性集群配置

在这个部分，我们将解释如何配合以下说明使用 AWS Management Console 或 AWS CLI，修改弹性集群。

修改集群的主要用途是通过增加或减少分片数目和/或分片计算容量来扩展分片。

Using the AWS Management Console

要使用 AWS Management Console 修改弹性集群配置：

登录 AWS Management Console 并打开 Amazon DocumentDB 控制台。
在导航窗格中，选择集群。

提示
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
在集群标识符列中选择您想要修改的集群的名称。
选择修改。
编辑您想要更改的字段，然后选择修改群集。

注意

或者，您可以通过以下方式访问修改集群对话框：转到集群页面，勾选紧邻您集群的复选框，选择操作，然后选择修改。

Using the AWS CLI

要使用 AWS CLI 修改弹性集群配置，请使用带以下参数的 update-cluster 操作：

--cluster-arn – 必填项。要删除的集群的 ARN 标识符。
--shard-capacity—可选。分配给每个分片的 vCPU 的数目。最大值为 64。允许值为 2、4、8、16、32、64。
--shard-count—可选。分配给集群的分片的数目。最大值为 32。
--shard-instance-计数 — 可选。适用于此集群中所有分片的副本实例数量。最大值为 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。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 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 Management Console 或 AWS CLI，监控弹性集群。

Using the AWS Management Console

要使用 AWS Management Console 监控弹性集群配置：

登录 AWS Management Console 并打开 Amazon DocumentDB 控制台。
在导航窗格中，选择集群。

提示
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
在集群标识符列中选择您想要监控的集群的名称。
选择监控选项卡。

对于以下监控类别，显示来自 Amazon CloudWatch 的众多图表：

资源利用率
吞吐量
延迟
操作
系统

您也可以经由 AWS Management Console 访问 Amazon CloudWatch，为您的弹性集群设置自己的监控环境。

Using the AWS CLI

要使用 AWS CLI 监控特定弹性集群配置，请使用带以下参数的 get-cluster 操作：

--cluster-arn – 必填项。要获取其信息的集群的 ARN 标识符。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 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

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 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 Management Console 或 AWS CLI，删除弹性集群。

Using the AWS Management Console

要使用 AWS Management Console 删除弹性集群配置：

登录 AWS Management Console 并打开 Amazon DocumentDB 控制台。
在导航窗格中，选择集群。

提示
如果您在屏幕左侧没有看到导航窗格，请在导航窗格左上角选择菜单图标。
在集群列表表中，选择在您想要删除的集群名称左侧的复选框，然后选择操作。从下拉菜单中，选择删除。
在是否删除“集群名称” 弹性集群？对话框中，选择删除。

删除集群需要几分钟时间。要监控集群的状态，请参阅监控 Amazon DocumentDB 集群的状态。

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 的的集群。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 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 的集群。

在以下示例中，将每个用户输入占位符替换为您自己的信息。

对于 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 集群的状态。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

最佳实践

管理弹性集群快照

管理弹性集群

主题

修改弹性集群配置

提示

注意

监控弹性集群

提示

删除弹性集群

提示