修改 Amazon DocumentDB实例

您可以使用 Amazon DocumentDB或 AWS 管理控制台 修改 AWS CLI. 实例。要修改实例，实例必须处于可用 状态。您无法修改已停止的实例。如果集群已停止，则首先启动集群，等待实例进入可用 状态，然后进行所需修改。有关更多信息，请参阅 停止和启动 Amazon DocumentDB 集群.

使用 AWS 管理控制台

要使用控制台修改特定 Amazon DocumentDB 实例，请完成以下步骤。

  1. 通过以下网址登录 AWS 管理控制台并打开 Amazon DocumentDB 控制台：https://console.aws.amazon.com/docdb。

  2. 在导航窗格中，选择 Clusters.

    提示

    如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (修改 实例 - 图1)。

  3. 在“Clusters （集群）”导航窗格中，您将看到 Cluster Identifier （集群标识符） 列。您的实例将在集群下列出，与以下屏幕截图类似。

    修改 实例 - 图2

  4. 选中要修改的实例左侧的框。

  5. 选择 Actions (操作)，然后选择 Modify (修改).

  6. 在 Modify instance： <instance-name> （修改实例： <实例名称>） 窗格中，进行所需的更改。您可以进行以下更改：

    • 实例规范 — 实例标识符和类。实例标识符命名约束：

      • Instance identifier — 对于您的 AWS 账户在当前区域中拥有的所有实例，输入一个唯一的名称。实例标识符必须包含 [1—63] 个字母数字字符或连字符，并将字母作为第一个字符，并且不能以连字符结尾或包含两个连续的连字符。

      • 实例类 从下拉菜单中选择 — 实例的实例类。Amazon DocumentDB有关更多信息，请参阅 管理实例类.

    • 证书颁发机构 —此实例的服务器证书。有关更多信息，请参阅 更新 Amazon DocumentDB TLS 证书.

    • 故障转移 — 在故障转移期间，具有最高提升层的实例将被提升为主实例。有关更多信息，请参阅 Amazon DocumentDB故障转移.

    • 维护 — 在维护窗口中将待处理的修改或修补程序应用于集群中的实例。

  7. 完成后，选择 Continue （继续） 以查看更改摘要。

  8. 在确认您的更改后，您可以立即应用这些更改，也可以在 Scheduling of modifications (修改计划). 下的下一个维护时段内应用这些更改。选择 Modify instance （修改实例） 以保存您的更改。或者，您可以选择 Cancel （取消） 以放弃更改。

需要几分钟时间才能应用更改。只有在实例状态为 available (可用). 时，才能使用实例。您可以使用控制台或 监控实例状态。AWS CLI. 有关更多信息，请参阅 监控 Amazon DocumentDB 实例的状态.

使用 AWS CLI

要使用 Amazon DocumentDB 修改特定 AWS CLI 实例，请使用具有以下参数的 modify-db-instance。有关更多信息，请参阅 ModifyDBInstance。以下代码为实例 db.r5.large 将实例类修改为 sample-instance.

Parameters

  • --db-instance-identifier — 必需。要修改的实例的标识符。

  • --db-instance-class — 可选。实例的新计算和内存容量；例如，db.r5.large。并非所有实例类在所有 AWS 区域中都可用。如果您修改实例类，则在更改期间会发生中断。更改在下一个维护时段内应用，除非此请求的 ApplyImmediately 指定为 true。

  • --apply-immediately 或 --no-apply-immediately — 可选。指定应立即应用此修改，还是等到下一个维护时段。如果省略此参数，则会在下一个维护时段执行修改。

对于 Linux、macOS 或 Unix:

  1. aws docdb modify-db-instance \
  2.        --db-instance-identifier sample-instance \
  3.        --db-instance-class db.r5.large \
  4.        --apply-immediately

对于 Windows:

  1. aws docdb modify-db-instance ^
  2.        --db-instance-identifier sample-instance ^
  3.        --db-instance-class db.r5.large ^
  4.        --apply-immediately

此操作的输出将类似于下文。

  1. {
  2.     "DBInstances": [
  3.         {
  4.             "DBInstanceIdentifier": "sample-instance-1",
  5.             "DBInstanceClass": "db.r5.large",
  6.             "Engine": "docdb",
  7.             "DBInstanceStatus": "modifying",
  8.             "Endpoint": {                     
  9.                 "Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
  10.                 "Port": 27017,   
  11.                 "HostedZoneId": "ABCDEFGHIJKLM"
  12.             },
  13.             "InstanceCreateTime": "2020-01-10T22:18:55.921Z",
  14.             "PreferredBackupWindow": "02:00-02:30",
  15.             "BackupRetentionPeriod": 1,
  16.             "VpcSecurityGroups": [
  17.                 {                             
  18.                     "VpcSecurityGroupId": "sg-abcd0123",
  19.                     "Status": "active"
  20.                 }
  21.             ],
  22.             "AvailabilityZone": "us-east-1a",
  23.             "DBSubnetGroup": {
  24.                 "DBSubnetGroupName": "default",
  25.                 "DBSubnetGroupDescription": "default",
  26.                 "VpcId": "vpc-abcd0123",
  27.                 "SubnetGroupStatus": "Complete",
  28.                 "Subnets": [
  29.                     {
  30.                         "SubnetIdentifier": "subnet-abcd0123",
  31.                         "SubnetAvailabilityZone": {
  32.                             "Name": "us-east-1a"
  33.                         },
  34.                         "SubnetStatus": "Active"
  35.                     },
  36.                     {
  37.                         "SubnetIdentifier": "subnet-abcd0123",
  38.                         "SubnetAvailabilityZone": {
  39.                             "Name": "us-east-1b"
  40.                         },
  41.                         "SubnetStatus": "Active"
  42.                     }
  43.                 ]
  44.             },
  45.             "PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
  46.             "PendingModifiedValues": {
  47.                 "DBInstanceClass": "db.r5.large"
  48.             },
  49.             "EngineVersion": "3.6.0",
  50.             "AutoMinorVersionUpgrade": true,
  51.             "PubliclyAccessible": false,
  52.             "DBClusterIdentifier": "sample-cluster",
  53.             "StorageEncrypted": true,
  54.             "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
  55.             "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
  56.             "CACertificateIdentifier": "rds-ca-2019",
  57.             "PromotionTier": 1,                     
  58.             "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
  59.             "EnabledCloudwatchLogsExports": [
  60.                 "profiler"
  61.             ]
  62.         }
  63.     ]
  64. }

需要几分钟时间才能应用修改。只有在实例状态为 available (可用). 时，才能使用实例。您可以使用 AWS 管理控制台或 AWS CLI. 监控实例状态。有关更多信息，请参阅 监控 Amazon DocumentDB 实例的状态.