本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
修改 Amazon DocumentDB集群
要修改集群，该集群必须处于 可用 状态。您无法修改已停止的集群。如果集群已停止，则首先启动集群，等待集群进入可用状态，然后进行所需修改。有关更多信息，请参阅停止和启动 Amazon DocumentDB 集群。
使用 AWS 管理控制台
通过以下过程使用控制台修改特定 Amazon DocumentDB集群。
修改 Amazon DocumentDB集群
-
通过以下网址登录 AWS 管理控制台并打开 Amazon DocumentDB 控制台：https://console.amazonaws.cn/docdb
。 -
在导航窗格中，选择 Clusters。
提示 如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (
)。
-
通过选择集群名称左侧的按钮，指定要修改的集群。
-
选择 Actions (操作)，然后选择 Modify (修改)。
-
在 Modify Cluster: cluster-name (修改集群: cluster-name) 窗格中，进行所需更改。您可以更改以下方面：
-
集群规范 — 集群的名称、安全组和密码。
-
集群选项 — 集群的端口和参数组。
-
备份 — 集群的备份保留期和备份时段。
-
日志导出—启用或禁用导出审计日志或分析器日志。
-
维护 — 设置集群的维护时段。
-
删除保护 — 对集群启用或禁用删除保护。默认情况下，将启用删除保护。
-
-
完成后，选择 Continue (继续) 以查看更改摘要。
-
如果您对所做更改满意，可以选择 Modify cluster (修改集群) 以修改集群。或者，您可以选择 Back (返回) 或 Cancel (取消) 来编辑或取消您的更改。
需要几分钟时间才能应用更改。只有在实例状态为 available (可用) 时，才能使用集群。您可以使用控制台或 AWS CLI 监控集群状态。有关更多信息，请参阅监控 Amazon DocumentDB 集群状态。
使用 AWS CLI
使用 modify-db-cluster 操作以使用 AWS CLI 修改指定的集群。有关更多信息，请参阅 ModifyDBCluster API 参考Amazon DocumentDB中的 。
Parameters
-
--db-cluster-identifier—必需。您要修改的 Amazon DocumentDB 集群的标识符。 -
--backup-retention-period—可选。自动备份的保留天数。有效值为 1–35。 -
--db-cluster-parameter-group-name—可选。用于集群的集群参数组的名称。 -
--master-user-password—可选。主数据库用户的新密码。密码约束：
-
长度为 [8—100] 个可打印 ASCII 字符。
-
可以使用任何可打印 ASCII 字符，以下字符除外：
-
/（正斜杠） -
"（双引号） -
@（@ 符号）
-
-
-
--new-db-cluster-identifier—可选。重命名集群时集群的新集群标识符。此值以一个小写字符串存储。命名约束：
-
长度为 [1—63] 个字母、数字或连字符。
-
第一个字符必须是字母。
-
不能以连字符结束或包含两个连续连字符。
-
对于每个区域的每个 AWS 账户的 Amazon RDS、Amazon Neptune 和 Amazon DocumentDB 必须是唯一的。
-
-
--preferred-backup-window—可选。创建自动备份的每日时间范围，以通用协调时间 (UTC) 表示。-
格式：
hh24:mm-hh24:mm
-
-
--preferred-maintenance-window—可选。可能进行系统维护的每周时间范围，以 UTC 表示。-
格式：
ddd:hh24:mm-ddd:hh24:mm -
有效天数
Sun：、Mon、Tue、Wed、Thu、Fri和Sat。
-
-
--deletion-protection或--no-deletion-protection—可选。是否应在此集群上启用删除保护。删除保护可以防止集群被意外删除，直到修改集群以禁用删除保护。有关更多信息，请参阅删除 Amazon DocumentDB集群。 -
--apply-immediately或--no-apply-immediately— 使用--apply-immediately可立即进行更改。使用--no-apply-immediately在集群的下一个维护时段期间进行更改。
以下代码将更改集群 sample-cluster 的备份保留期。
对于 Linux、macOS 或 Unix:
aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --apply-immediately \ --backup-retention-period 7
对于 Windows:
aws docdb modify-db-cluster ^ --db-cluster-identifier sample-cluster ^ --apply-immediately ^ --backup-retention-period 7
此操作的输出将类似于下文。
{
"DBCluster": {
"BackupRetentionPeriod": 7,
"DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
"Status": "available",
"DBClusterMembers": [
{
"PromotionTier": 1,
"DBClusterParameterGroupStatus": "in-sync",
"DBInstanceIdentifier": "sample-cluster-instance",
"IsClusterWriter": true
}
],
"ReadReplicaIdentifiers": [],
"AvailabilityZones": [
"us-east-1b",
"us-east-1c",
"us-east-1a"
],
"ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
"EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
"StorageEncrypted": false,
"MultiAZ": false,
"AssociatedRoles": [],
"MasterUsername": "<your-master-user-name>",
"DBClusterIdentifier": "sample-cluster",
"VpcSecurityGroups": [
{
"Status": "active",
"VpcSecurityGroupId": "sg-77186e0d"
}
],
"HostedZoneId": "Z2SUY0A1719RZT",
"LatestRestorableTime": "2018-06-18T21:17:05.737Z",
"AllocatedStorage": 1,
"Port": 27017,
"Engine": "docdb",
"DBClusterParameterGroup": "default.docdb3.4",
"Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBSubnetGroup": "default",
"PreferredBackupWindow": "00:00-00:30",
"EngineVersion": "3.4",
"ClusterCreateTime": "2018-06-06T19:25:47.991Z",
"IAMDatabaseAuthenticationEnabled": false
}
}需要几分钟时间才能应用更改。只有在实例状态为 available (可用) 时，才能使用集群。您可以使用控制台或 AWS CLI 监控集群状态。有关更多信息，请参阅监控 Amazon DocumentDB 集群状态。