管理弹性集群

要管理亚马逊 DocumentDB 弹性集群，您必须拥有具有相应亚马逊 DocumentDB 控制平面权限的IAM策略。这些权限使您能够创建、修改和删除集群。Amazon D A ocumentDBFull ccess 策略提供了管理亚马逊 DocumentDB 弹性集群所需的所有权限。

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

主题

修改弹性集群配置

在本节中，我们将说明如何使用 AWS Management Console 或 AWS CLI 并按照以下说明修改弹性集群。

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

Using the AWS Management Console

要使用以下命令修改弹性集群配置 AWS Management Console：

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

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

注意

或者，您可以访问修改集群对话框，方法是转到集群页面，选中集群旁边的复选框，选择操作，然后选择修改。

Using the AWS CLI

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

--cluster-arn – 必填项。要修改的集群的ARN标识符。
--shard-capacity—可选。 vCPUs 分配给每个分片的数量。最大值为 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—可选。配置要与此集群关联的亚马逊EC2和亚马逊虚拟私有云 Virtual Private Cloud (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 Management Console 或 AWS CLI 以及以下说明监控您的弹性集群。

Using the AWS Management Console

要使用以下方法监控弹性集群配置 AWS Management Console：

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

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

Amazon CloudWatch 为以下监控类别显示了许多图表：

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

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

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—可选。如果 output (--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 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: aws: docdb: us-west-2:1234567 ARN 89012: 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: aws: docdb: us-west-2:12 ARN 3456789012: 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 集群的状态。

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

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

文档惯例

最佳实践

管理弹性集群快照

管理弹性集群

主题

修改弹性集群配置

提示

注意

监控弹性集群

提示

删除弹性集群

提示