本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 修改 Amazon DocumentDB 叢集
若要修改叢集，叢集必須處於*可用*狀態。您無法修改已停止的叢集。如果叢集已停止，請先啟動叢集，等待叢集變成*可用*，然後進行所需的修改。如需詳細資訊，請參閱[停止和啟動 Amazon DocumentDB 叢集](db-cluster-stop-start.md)。
------
#### [ Using the AWS 管理主控台 ]
使用下列程序，使用主控台修改特定的 Amazon DocumentDB 叢集。
**修改 Amazon DocumentDB 叢集**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) 開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇**叢集**。
**提示**
如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。
1. 選擇叢集名稱左側的按鈕，以指定您要修改的叢集。
1. 選擇 **Actions (動作)**，然後選擇 **Modify (修改)**。
1. 在 **Modify Cluster: (修改叢集: <叢集-名稱>)** 窗格中，進行您要的變更。您可以在以下領域進行變更：
+ **叢集規格** - 叢集的名稱、安全群組和登入資料管理。
+ **叢集儲存組態** - 叢集的資料儲存模式。選擇標準和 I/O 最佳化組態。
+ **叢集選項** - 叢集的連接埠和參數群組。
+ **Backup** - 叢集的備份保留期和備份時段。
+ **日誌匯出 **- 啟用或停用匯出稽核或分析器日誌。
+ **維護** - 設定叢集的維護時段。
+ **刪除保護** - 在叢集上啟用或停用刪除保護。預設會啟用刪除保護。
1. 完成後，請選擇 **Continue (繼續)** 以檢視變更的摘要。
1. 如果您滿意變更，可以選擇 **Modify cluster (修改叢集)** 來修改叢集。或者，您也可以選擇 **Back (返回)** 或 **Cancel (取消)**，分別編輯或取消變更。
套用您的變更需要幾分鐘的時間才會完成。您只能使用狀態為*可用*的叢集。您可以使用主控台或 AWS CLI監控叢集的狀態。如需詳細資訊，請參閱[監控 Amazon DocumentDB 叢集的狀態](monitoring_docdb-cluster_status.md)。
------
#### [ Using the AWS CLI ]
使用 AWS CLI透過 `modify-db-cluster` 操作來修改指定的叢集。如需詳細資訊，請參閱《*Amazon DocumentDB API 參考*[https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html)》中的 。
**Parameters**
+ **--db-cluster-identifier** - 必要項目。您要修改之 Amazon DocumentDB 叢集的識別符。
+ **--backup-retention-period**- 選用。自動備份保留的天數。有效值為 1–35。
+ **--storage-type**- 選用。叢集的儲存組態。有效值為 `standard`（標準） 或 `iopt1`(I/O 最佳化）。
+ **--db-cluster-parameter-group-name**- 選用。要用於叢集的叢集參數群組名稱。
+ **--manage-master-user-password**- 選用。Amazon DocumentDB 會產生主要使用者密碼，並在 Secrets Manager 的整個生命週期中進行管理。
+ **--rotate-master-user-password**- 選用。Secrets Manager 會為現有秘密產生新的秘密版本。新版本的秘密包含新的主要使用者密碼。Amazon DocumentDB 會變更叢集的主要使用者密碼，以符合新秘密版本的密碼。
輪換主要密碼時，您必須指定 **--apply-immediately**選項。
+ **--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 叢集](db-cluster-delete.md)。
+ **--apply-immediately** 或 **--no-apply-immediately**— 用來立即`--apply-immediately`進行變更。使用 `--no-apply-immediately` 可在叢集下一次維護時段進行變更。
**Example**
以下程式碼會變更 `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": "",
"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 叢集的狀態](monitoring_docdb-cluster_status.md)。
------