管理 Amazon DocumentDB 弹性集群

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

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

主题

修改弹性集群配置

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

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

Using the AWS 管理控制台

要使用以下命令修改弹性集群配置 AWS 管理控制台：

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

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

注意

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

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-计数 — 可选。适用于此集群中所有分片的副本实例数量。最大值为 16。
--auth-type—可选。用于确定从何处获取用于访问弹性集群的密码的身份验证类型。有效类型为 PLAIN_TEXT 和 SECRET_ARN。
--admin-user-password—可选。与管理用户关联的密码。
--vpc-security-group-ids—可选。配置要与此集群关联的亚马逊 EC2 和亚马逊虚拟私有云 (VPC) Virtual Private Cloud 安全组列表。
--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 管理控制台：

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

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

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 管理控制台删除弹性集群配置：

登录 AWS 管理控制台并打开 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 的集群，并进行最终备份。

在以下示例中，用您自己的信息替换每个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 集群的状态。

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

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

文档惯例

最佳实践

管理弹性集群快照

管理 Amazon DocumentDB 弹性集群

主题

修改弹性集群配置

提示

注意

监控弹性集群

提示

删除弹性集群

提示