修改 Amazon DocumentDB 叢集

若要修改叢集，叢集必須處於可用狀態。您無法修改已停止的叢集。如果叢集已停止，請先啟動叢集，等待叢集變成可用，然後進行所需的修改。如需詳細資訊，請參閱 停止和啟動 Amazon DocumentDB 集群。

Using the AWS Management Console

使用下列程序來使用主控台修改特定的 Amazon DocumentDB 叢集。

若要修改亞 Amazon DocumentDB 叢集

1. 登入 AWS Management Console，然後在 https://console.aws.amazon.com/docdb 開啟 Amazon DocumentDB 主控台。

2. 在導覽窗格中，選擇叢集。

   提示

   如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 ()。

3. 選擇叢集名稱左側的按鈕，以指定您要修改的叢集。

4. 選擇 Actions (動作)，然後選擇 Modify (修改)。

5. 在 Modify Cluster: <cluster-name> (修改叢集: <叢集-名稱>) 窗格中，進行您要的變更。您可以在以下領域進行變更：

   • 叢集規格 — 叢集的名稱、安全群組和密碼。

   • 叢集儲存配置 — 叢集的資料儲存模式。在「標準」和「I/O 最佳化」組態之間選擇。

   • 叢集選項 — 叢集的連接埠和參數群組。

   • Backup — 叢集的備份保留期和備份時段。

   • 記錄匯出 — 啟用或停用匯出稽核或效能分析工具記錄。

   • 維護 — 設定叢集的維護時段。

   • 刪除保護 — 啟用或停用叢集上的刪除保護。預設會啟用刪除保護。

6. 完成後，請選擇 Continue (繼續) 以檢視變更的摘要。

7. 如果您滿意變更，可以選擇 Modify cluster (修改叢集) 來修改叢集。或者，您也可以選擇 Back (返回) 或 Cancel (取消)，分別編輯或取消變更。

套用您的變更需要幾分鐘的時間才會完成。您只能使用狀態為可用的叢集。您可以使用主控台或 AWS CLI監控叢集的狀態。如需詳細資訊，請參閱 監控 Amazon DocumentDB 集群的狀態。

Using the AWS CLI

使用 AWS CLI透過 modify-db-cluster 操作來修改指定的叢集。如需詳細資訊，請參閱ModifyDBCluster亞 Amazon DocumentDB API 參考中的。

參數

• --db-cluster-identifier - 必要項目。您要修改之 Amazon DocumentDB 叢集的識別碼。

• --backup-retention-period選擇性。自動備份保留的天數。有效值為 1—35。

• --storage-type選擇性。叢集的儲存配置。有效值為 standard (標準) 或 iopt1 (I/O 最佳化)。

• --db-cluster-parameter-group-name選擇性。要用於叢集的叢集參數群組名稱。

• --master-user-password選擇性。主要資料庫使用者的新密碼。

  密碼限制條件：

  • 長度為 [8—100] 可列印的 ASCII 字元。

  • 可以使用下列項目以外的任何可列印 ASCII 字元：

    • / (正斜線)

    • " (雙引號)

    • @ (@ 符號)

• --new-db-cluster-identifier選擇性。重新命名叢集時，叢集的新叢集識別碼。此值會以小寫字母字串的形式儲存。

  命名限制：

  • 長度為 [1—63] 字母、數字或連字號。

  • 第一個字元必須是字母。

  • 不能以連字號結尾或連續包含兩個連字號。

  • 對於跨 Amazon RDS、亞馬遜 Amazon Neptune 和 Amazon DocumentDB 的所有叢集，每 AWS 帳戶個區域都必須是唯一的。

• --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
    }
}

套用您的變更需要幾分鐘的時間才會完成。您只能使用狀態為可用的叢集。您可以使用主控台或 AWS CLI監控叢集的狀態。如需詳細資訊，請參閱 監控 Amazon DocumentDB 集群的狀態。