本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 管理 Amazon DocumentDB 彈性叢集
若要管理 Amazon DocumentDB 彈性叢集，您必須擁有具有適當 Amazon DocumentDB 控制平面許可的 IAM 政策。這些許可可讓您建立、修改和刪除叢集。Amazon DocumentDBFullAccess 政策提供管理 Amazon DocumentDB 彈性叢集的所有必要許可。
下列主題說明如何在使用 Amazon DocumentDB 彈性叢集時執行各種任務。
**Topics**
+ [修改彈性叢集組態](#elastic-modify)
+ [監控彈性叢集](#elastic-monitor)
+ [刪除彈性叢集](#elastic-delete)
+ [管理彈性叢集快照](elastic-manage-snapshots.md)
+ [停止和啟動 Amazon DocumentDB 彈性叢集](elastic-cluster-stop-start.md)
+ [維護 Amazon DocumentDB 彈性叢集](elastic-cluster-maintenance.md)
## 修改彈性叢集組態
在本節中，我們會說明如何使用 AWS 管理主控台 或 AWS CLI 搭配下列指示來修改彈性叢集。
修改叢集的主要用途是透過增加或減少碎片計數和/或碎片運算容量來擴展碎片。
------
#### [ Using the AWS 管理主控台 ]
若要使用 修改彈性叢集組態 AWS 管理主控台：
1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇**叢集**。
**提示**
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。
1. 在叢集**識別符欄中選擇您要修改的叢集**名稱。
1. 選擇 **Modify** (修改)。
1. 編輯您要變更的欄位，然後選取**修改叢集**。
![\[表格顯示可修改的組態、維護、身分驗證和網路設定選項，修改叢集按鈕位於右下角。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/cluster-shard-modify-3.png)
**注意**
或者，您可以前往**叢集**頁面，勾選**叢集**旁的方塊，選擇**動作**，然後選擇修改，以存取**修改**叢集對話方塊。
------
#### [ Using the AWS CLI ]
若要使用 修改彈性叢集組態 AWS CLI，請使用 `update-cluster`操作搭配下列參數：
+ **--cluster-arn** - 必要項目。您要修改之叢集的 ARN 識別符。
+ **--shard-capacity**- 選用。指派給每個碎片vCPUs 數量。上限為 64。允許的值為 2、4、8、16、32、64。
+ **--shard-count**- 選用。指派給叢集的碎片數量。上限為 32。
+ **--shard-instance**-count - 選用。套用至此叢集中所有碎片的複本執行個體數目。上限為 16。
+ **--auth-type**- 選用。用來決定在何處擷取用於存取彈性叢集之密碼的身分驗證類型。有效類型為 `PLAIN_TEXT`或 `SECRET_ARN`。
+ **--admin-user-password**- 選用。與管理員使用者相關聯的密碼。
+ **--vpc-security-group-ids**- 選用。設定要與此叢集建立關聯的 Amazon EC2 和 Amazon Virtual Private Cloud (VPC) 安全群組清單。
+ **--preferred-maintenance-window**- 選用。設定每週可以進行系統維護的時間範圍，以國際標準時間 (UTC) 為單位
格式為：`ddd:hh24:mi-ddd:hh24:mi`。有效天數 (ddd)：週一、週二、週三、週四、週五、週六、週日
預設值是從每個 Amazon Web Services 區域的 8 小時時段中隨機選取的 30 分鐘時段，該時段隨機發生在一週中的某一天。
最短 30 分鐘時段。
+ **--subnet-ids**- 選用。設定網路子網路 ID。
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
針對 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 管理主控台：
1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇**叢集**。
**提示**
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。
1. 在叢集**識別符欄中選擇您要監控的叢集**名稱。
1. 選擇 **Monitoring** (監控) 索引標籤。
![\[彈性叢集摘要資訊會顯示在監控索引標籤中。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/cluster-shard-monitor-2.png)
下列監控類別會顯示來自 Amazon CloudWatch 的數個圖表：
+ 資源使用率
+ 輸送量
+ 作業
+ 系統
您也可以透過 存取 Amazon CloudWatch AWS 管理主控台 ，為您的彈性叢集設定自己的監控環境。
------
#### [ Using the AWS CLI ]
若要使用 監控特定彈性叢集組態 AWS CLI，請使用 `get-cluster`操作搭配下列參數：
+ **--cluster-arn** - 必要項目。您想要其資訊的叢集 ARN 識別符。
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
針對 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 Resource Management API 參考`DescribeClusterSnapshot`》中的 。
若要使用 檢視所有彈性叢集的詳細資訊 AWS CLI，請使用 `list-clusters`操作搭配下列參數：
+ **--next-token**- 選用。如果項目輸出數量 (`--max-results`) 少於基礎 API 呼叫傳回的項目總數，則輸出會包含一個 `NextToken`，提供您在後續命令中傳送以擷取下一組項目。
+ **--max-results**- 選用。要在命令輸出中傳回的總項目數。如果存在的結果超過指定的`max-results`值，則會在回應中包含分頁字符 (`next-token`)，以便擷取剩餘的結果。
+ 預設：100
+ 最小值為 20，最大值為 100
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
針對 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 管理主控台：
1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇**叢集**。
**提示**
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。
1. 在叢集清單表格中，選取您要刪除之叢集名稱左側的核取方塊，然後選擇**動作**。從下拉式選單中選擇 **Detete (刪除)**。
1. 在**刪除「叢集名稱」彈性叢集？**對話方塊中，選擇**刪除**。
![\[刪除對話方塊，使用右下角的刪除按鈕。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/cluster-delete-dialog.png)
刪除叢集需要幾分鐘的時間。若要監控叢集的狀態，請參閱[監控 Amazon DocumentDB 叢集的狀態](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html)。
------
#### [ 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 的叢集。
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
針對 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 的叢集，無需進行最終備份。
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
針對 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 叢集的狀態](https://docs.aws.amazon.com/documentdb/latest/developerguide/monitoring_docdb-cluster_status.html)。
------
# 管理彈性叢集快照
建立彈性叢集後，即可取得手動快照。自動備份會在建立彈性叢集快照時建立。
**注意**
您的彈性叢集必須處於 `Available` 狀態，才能取得手動快照。
本節說明如何建立、檢視、還原和刪除彈性叢集快照。
下列主題說明如何在使用 Amazon DocumentDB 彈性叢集快照時執行各種任務。
**Topics**
+ [建立手動彈性叢集快照](#elastic-create-snapshot)
+ [檢視彈性叢集快照](#elastic-view-snapshot)
+ [從快照還原彈性叢集](#elastic-restore-snapshot)
+ [複製彈性叢集快照](#elastic-copy-snapshot)
+ [刪除彈性叢集快照](#elastic-delete-snapshot)
+ [管理彈性叢集快照自動備份](#elastic-auto-snapshot)
## 建立手動彈性叢集快照
在本節中，我們將說明如何使用 AWS 管理主控台 或 AWS CLI 搭配下列指示來建立手動彈性叢集快照。
------
#### [ Using the AWS 管理主控台 ]
若要使用 建立手動彈性叢集快照 AWS 管理主控台：
1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇 **Snapshots** (快照)。
**提示**
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。
1. 在 **Snapshots (快照)** 頁面選擇 **Create (建立)**。
1. 在**建立叢集快照**頁面上的**叢集識別符**欄位中，從下拉式清單中選擇您的彈性叢集。
在**快照識別符**欄位中，輸入彈性叢集的唯一識別符。
選擇**建立**。
![\[圖表：彈性叢集建立快照\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/elastic-create-snapshot.png)
**注意**
或者，您可以前往**叢集**頁面，勾選叢集旁的方塊，然後選擇**動作**，然後**拍攝快照**，以存取**建立**叢集快照對話方塊。
您的彈性叢集快照現在正在佈建。這可能需要幾分鐘的時間才能完成。當狀態`Available`在快照清單中顯示為 時，您可以從**快照**檢視和還原。
------
#### [ Using the AWS CLI ]
若要使用 建立手動彈性叢集快照 AWS CLI，請使用 `create-cluster-snapshot`操作搭配下列參數：
+ **--snapshot-name** - 必要項目。您要建立的叢集快照名稱。
+ **--cluster-arn** - 必要項目。您要建立快照之叢集的 ARN 識別符。
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
針對 Linux、macOS 或 Unix：
```
aws docdb-elastic create-cluster-snapshot \
--snapshot-name sample-snapshot-1 \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
針對 Windows：
```
aws docdb-elastic create-cluster-snapshot ^
--snapshot-name sample-snapshot-1 ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
------
## 檢視彈性叢集快照
在本節中，我們會說明如何使用 AWS 管理主控台 或 AWS CLI 搭配下列指示來檢視彈性叢集快照資訊。
------
#### [ Using the AWS 管理主控台 ]
若要使用 檢視特定彈性叢集快照的相關資訊 AWS 管理主控台：
1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇 **Snapshots** (快照)。
**提示**
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。
1. 在**快照**頁面上，按一下**快照識別符**欄中的名稱，從清單中選擇快照。
1. 在**詳細資訊**中檢視快照的資訊。
![\[圖表：彈性叢集檢視快照\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/elastic-snapshot-view.png)
------
#### [ Using the AWS CLI ]
若要使用 檢視特定彈性叢集快照的相關資訊 AWS CLI，請使用 `get-cluster-snapshot`操作搭配下列參數：
+ **--snapshot-arn** - 必要項目。您想要其資訊的快照 ARN 識別符。
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
針對 Linux、macOS 或 Unix：
```
aws docdb-elastic get-cluster-snapshot \
--snapshot-arn sampleResourceName
```
針對 Windows：
```
aws docdb-elastic get-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
若要使用 檢視特定彈性叢集快照的相關資訊 AWS CLI，請使用 `get-cluster-snapshot`操作搭配下列參數：
+ **--snapshot-arn** - 必要項目。您想要其資訊的快照 ARN 識別符。
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
針對 Linux、macOS 或 Unix：
```
aws docdb-elastic get-cluster-snapshot \
--snapshot-arn sampleResourceName
```
針對 Windows：
```
aws docdb-elastic get-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
若要使用 檢視所有彈性叢集快照的相關資訊 AWS CLI，請使用 `list-cluster-snapshots`操作搭配下列參數：
+ **--snapshot-type**- 選用。要傳回的叢集快照類型。您可以指定下列其中一個值：
+ `automated` - 傳回 Amazon DocumentDB 為 AWS 您的帳戶自動建立的所有叢集快照。
+ `manual` - 傳回您為 AWS 帳戶手動建立的所有叢集快照。
+ `shared` - 傳回已與 AWS 您的帳戶共用的所有手動叢集快照。
+ `public` - 傳回已標記為公有的所有叢集快照。
+ **--next-token**- 選用。前一個請求提供的選用分頁字符。如果指定此參數，回應只會包含超過此字符的記錄，直到 指定的值為止`max-results`。
+ **--max-results**- 選用。要在回應中包含的結果數目上限。如果存在的結果超過指定的`max-results`值，回應中會包含分頁字符 (`next-token`)，以便擷取剩餘的結果。
+ 預設：100
+ 最小值為 20，最大值為 100
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
針對 Linux、macOS 或 Unix：
```
aws docdb-elastic list-cluster-snapshots \
--snapshot-type value \
--next-token value \
--max-results 50
```
針對 Windows：
```
aws docdb-elastic list-cluster-snapshots ^
--snapshot-type value ^
--next-token value ^
--max-results 50
```
------
## 從快照還原彈性叢集
在本節中，我們會說明如何使用 AWS 管理主控台 或 AWS CLI 搭配下列指示，從快照還原彈性叢集。
------
#### [ Using the AWS 管理主控台 ]
若要使用 從快照還原彈性叢集 AWS 管理主控台：
1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇 **Snapshots** (快照)。
**提示**
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。
1. 在快照**識別符**欄中，選擇您要用來還原叢集的快照左側按鈕。
1. 選擇**動作**，再選擇**還原**。
![\[圖表：從快照彈性叢集還原\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/elastic-restore-snapshot.png)
1. 在**還原快照**頁面上，在叢集**識別符**欄位中輸入新叢集的名稱。
**注意**
對於任何手動快照還原，您必須建立新的叢集。
1. 在**虛擬私有雲端 (VPC)** 欄位中，從下拉式清單中選擇 VPC。
1. 對於**子網路**和 **VPC 安全群組**，您可以使用預設值或選取您選擇的三個子網路，以及最多三個 VPC 安全群組 （至少一個）。
1. 如果您滿意此叢集組態，請選擇 **Restore cluster (還原叢集)**，等待叢集還原。
------
#### [ Using the AWS CLI ]
若要使用 從快照還原彈性叢集 AWS CLI，請使用 `restore-cluster-from-snapshot`操作搭配下列參數：
+ **--cluster-name** - 必要項目。在建立或上次修改期間輸入的彈性叢集的目前名稱。
+ **--snapshot-arn** - 必要項目。用於還原叢集之快照的 ARN 識別符。
+ **--vpc-security-group-ids**- 選用。要與叢集建立關聯的一或多個 Amazon EC2 和 Amazon Virtual Private Cloud (VPC) 安全群組。
+ **--kms-key-id**- 選用。設定加密叢集的 KMS 金鑰識別符。
KMS 金鑰識別符是 AWS KMS 加密金鑰的 Amazon Resource Name (ARN)。如果您使用擁有用來加密新叢集之 KMS 加密金鑰的相同 Amazon Web Services 帳戶來建立叢集，您可以使用 KMS 金鑰別名，而不是 KMS 加密金鑰的 ARN。
如果未在 KmsKeyId 中指定加密金鑰，且 `StorageEncrypted` 參數為 true，Amazon DocumentDB 會使用預設加密金鑰。
+ **--subnet-ids**- 選用。網路子網路 ID。
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
針對 Linux、macOS 或 Unix：
```
aws docdb-elastic restore-cluster-from-snapshot \
--cluster-name elastic-sample-cluster \
--snapshot-arn sampleResourceName \
--vpc-security-group-ids value ec-65f40350 \
--kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
針對 Windows：
```
aws docdb-elastic restore-cluster-from-snapshot ^
--cluster-name elastic-sample-cluster ^
--snapshot-arn sampleResourceName ^
--vpc-security-group-ids value ec-65f40350 ^
--kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
------
## 複製彈性叢集快照
在 Amazon DocumentDB 中，您可以在相同區域和相同帳戶中複製手動和自動彈性叢集快照。在本節中，我們會說明如何使用 AWS 管理主控台 或 複製彈性叢集快照 AWS CLI。
------
#### [ Using the AWS 管理主控台 ]
若要使用 複製彈性叢集快照 AWS 管理主控台：
1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇 **Snapshots** (快照)。
**提示**
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。
1. 在快照**識別符**欄中，選擇您要複製的快照左側按鈕。
1. 選擇**動作**，然後選擇**複製**。
![\[圖表：彈性叢集複製快照\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/ec-copy-snapshot.png)
1. 針對**新快照識別符**，輸入新快照的名稱。
1. 對於**複製標籤**，如果您想要將所有標籤從來源彈性叢集快照複製到目標彈性叢集快照，請勾選此方塊。
1. 針對**加密**，選擇預設 AWS KMS 金鑰或您選擇的 KMS 金鑰。第二個選項可讓您選取已建立的現有 KMS 金鑰，或允許您建立新的 KMS 金鑰。
1. 完成後，請選擇**複製快照**。
------
#### [ Using the AWS CLI ]
若要使用 複製彈性叢集快照 AWS CLI，請使用 `copy-cluster-snapshot`操作搭配下列參數：
+ **‐‐source-db-cluster-snapshot-identifier** - 必要項目。要複製之現有彈性叢集快照的識別符。彈性叢集快照必須存在且處於可用狀態。此參數不區分大小寫。
+ **‐‐target-db-cluster-snapshot-identifier** - 必要項目。要從現有叢集快照建立之新彈性叢集快照的識別符。此參數不區分大小寫。
目標快照名稱限制條件：
+ 不能是現有快照的名稱。
+ 長度為 【1-63】 個字母、數字或連字號。
+ 第一個字元必須是字母。
+ 不能以連字號結尾，或包含兩個連續連字號。
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
針對 Linux、macOS 或 Unix：
```
aws docdb-elastic copy-cluster-snapshot \
‐‐source-cluster-snapshot-arn \
‐‐target-cluster-snapshot-name my-target-copied-snapshot
```
針對 Windows：
```
aws docdb-elastic copy-cluster-snapshot ^
‐‐source-cluster-snapshot-arn ^
‐‐target-cluster-snapshot-name my-target-copied-snapshot
```
------
## 刪除彈性叢集快照
在本節中，我們會說明如何使用 AWS 管理主控台 或 刪除彈性叢集快照 AWS CLI。
------
#### [ Using the AWS 管理主控台 ]
若要使用 從快照還原彈性叢集 AWS 管理主控台：
1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇 **Snapshots** (快照)。
**提示**
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。
1. 在快照**識別符**欄中，選擇您要用來還原叢集的快照左側按鈕。
1. 依序選擇**動作**和**刪除**。
![\[圖表：彈性叢集刪除快照\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/elastic-delete-snapshot.png)
1. 在**刪除「snapshot-name」快照**對話方塊中，選擇**刪除**。
------
#### [ Using the AWS CLI ]
若要使用 刪除彈性叢集快照 AWS CLI，請使用 `delete-cluster-snapshot`操作搭配下列參數：
+ **--snapshot-arn** - 必要項目。用於還原叢集之快照的 ARN 識別符。
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
針對 Linux、macOS 或 Unix：
```
aws docdb-elastic delete-cluster-snapshot \
--snapshot-arn sampleResourceName
```
針對 Windows：
```
aws docdb-elastic delete-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
------
## 管理彈性叢集快照自動備份
Amazon DocumentDB 會為您的彈性叢集拍攝每日快照。您可以在新的或現有的彈性叢集快照組態中指定偏好的備份時段和備份保留期間。在本節中，我們會說明如何使用 AWS 管理主控台 或 ，在彈性叢集快照中設定自動備份參數 AWS CLI。
------
#### [ Using the AWS 管理主控台 ]
若要使用 設定新彈性叢集快照的自動備份 AWS 管理主控台：
1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/docdb/home?region=us-east-1)並開啟 Amazon DocumentDB 主控台。
1. 在導覽窗格中，選擇**叢集**。
**提示**
如果您在螢幕左側沒有看到導覽窗格，請選擇導覽窗格左上角的選單圖示。
1. 在叢集**識別符**欄中，選擇您要變更其備份設定的叢集左側按鈕。
1. 選擇**動作**，然後選擇**修改**。
1. 在**備份**區段中，根據您的備份需求編輯欄位。
![\[備份窗格的螢幕擷取畫面，顯示設定叢集備份時段的步驟。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/ec-backup.png)
1. **備份保留期** - 在清單中，選擇在刪除叢集之前保留此叢集自動備份的天數。
1. **備份時段** - 設定 Amazon DocumentDB 要備份此叢集的每日時間和持續時間。
1. 如果您想要設定建立備份的時間和持續時間，請選擇**選取視窗**。
**開始時間** - 在第一個清單中，選擇啟動自動備份的開始時間小時 (UTC)。在第二個清單中，選擇您要自動備份開始進行的時間 (分)。
**持續時間** - 在清單中，選擇要配置給建立自動備份的時數。
1. 如果您希望 Amazon DocumentDB 選擇建立備份的時間和持續時間，請選擇**無偏好設定**。
1. 完成時選擇**修改叢集**。
------
#### [ Using the AWS CLI ]
若要使用 設定新彈性叢集快照的自動備份 AWS CLI，請使用 `create-cluster-snapshot`操作搭配下列參數：
+ **--preferred-backup-window**- 選用。建立自動備份的每日偏好時間範圍。預設值是從 8 小時時段中隨機選取的 30 分鐘時段 AWS 區域。
限制條件：
+ 格式必須為 `hh24:mi-hh24:mi`。
+ 必須以國際標準時間 (UTC) 表示。
+ 不得和慣用的維護時段衝突。
+ 必須至少 30 分鐘。
+ **--backup-retention-period**- 選用。自動備份保留的天數。預設值為 1.
限制條件：
+ 必須指定最小值 1。
+ 範圍從 1 到 35。
**注意**
只有在叢集處於「作用中」狀態時，才會進行自動備份。
**注意**
您也可以使用 `aws docdb-elastic update-cluster`命令修改現有彈性叢集的 `preferred-backup-window`和 `backup-retention-period` 參數。
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
下列`create-cluster`範例會建立 Amazon DocumentDB 彈性叢集 *sample-cluster*，其自動備份的保留期間為 *7* 天，而偏好的備份時段為 *18：00-18：30 UTC*。
針對 Linux、macOS 或 Unix：
```
aws docdb-elastic create-cluster \
--cluster-name sample-cluster \
--shard-capacity 2 \
--shard-count 2 \
--admin-user-name SampleAdmin \
--auth-type PLAIN_TEXT \
--admin-user-password SamplePass123! \
--preferred-backup-window 18:00-18:30 \
--backup-retention-period 7
```
針對 Windows：
```
aws docdb-elastic create-cluster ^
--cluster-name sample-cluster ^
--shard-capacity 2 ^
--shard-count 2 ^
--admin-user-name SampleAdmin ^
--auth-type PLAIN_TEXT ^
--admin-user-password SamplePass123! ^
--preferred-backup-window 18:00-18:30 ^
--backup-retention-period 7
```
------
# 停止和啟動 Amazon DocumentDB 彈性叢集
停止和啟動 Amazon DocumentDB 彈性叢集可協助您管理開發和測試環境的成本。您不需要在每次使用 Amazon DocumentDB 時建立和刪除彈性叢集，而是可以在不需要時暫時停止叢集。然後，您可以在繼續測試時再次啟動它。
**Topics**
+ [停止和啟動彈性叢集的概觀](#elastic-cluster-stop-start-overview)
+ [您可以在已停止的彈性叢集上執行的操作](#elastic-cluster-stopped-operations)
## 停止和啟動彈性叢集的概觀
在您不需要 Amazon DocumentDB 彈性叢集的期間，您可以停止叢集。一旦您需要叢集，即可隨時重新啟動它。啟動和停止可簡化彈性叢集的設定和縮減程序，這些彈性叢集用於不需要持續可用性的開發、測試或類似活動。您可以使用 AWS 管理主控台 或 AWS CLI 單一動作來停止和啟動彈性叢集。
當您的彈性叢集停止時，叢集儲存磁碟區會保持不變。您只需支付指定的保留時段內儲存、手動快照和自動備份儲存的費用。Amazon DocumentDB 會在七天後自動啟動您的彈性叢集，使其不會落後於任何必要的維護更新。當您的叢集在七天後啟動時，將會再次開始向您收取使用彈性叢集的費用。當叢集停止時，您無法查詢儲存磁碟區，因為查詢需要叢集處於可用狀態。
當 Amazon DocumentDB 彈性叢集停止時，無法以任何方式修改叢集。這包括刪除叢集。
------
#### [ Using the AWS 管理主控台 ]
下列程序說明如何在可用狀態下停止彈性叢集，或啟動已停止的彈性叢集。
**停止或啟動 Amazon DocumentDB 彈性叢集**
1. 登入 AWS 管理主控台，並在 [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. 在叢集清單中，選擇您要停止或啟動之叢集名稱左側的按鈕。
![\[叢集清單中的叢集，並選取叢集名稱左側的核取方塊。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/cluster-list-ec.png)
1. 選擇 **Actions (動作)**，然後選擇您想要在叢集上執行的動作。
+ 如果您想要停止可用的叢集：
1. 選擇**停止**。
![\[選取停止選項的動作下拉式清單。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/ec-stop.png)
1. 在確認對話方塊中，選擇停止叢集來確認您想要**停止彈性叢集**，或選擇**取消**以保持叢集執行。
![\[停止叢集的確認對話方塊，底部有取消和停止叢集按鈕。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/ec-stop-confirm.png)
+ 如果您想要啟動叢集，而叢集已停止，請選擇 **Start (啟動)**。
![\[選取開始選項的動作下拉式清單。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/ec-start.png)
1. 監控彈性叢集的狀態。如果您啟動叢集，您可以在叢集*可用*時繼續使用叢集。如需詳細資訊，請參閱[判斷叢集的狀態](db-cluster-status.md)。
![\[叢集資料表中顯示可用和啟動狀態的狀態欄。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/ec-starting-status.png)
------
#### [ Using the AWS CLI ]
下列程式碼範例示範如何在作用中或可用狀態下停止彈性叢集，或啟動已停止的彈性叢集。
若要使用 停止彈性叢集 AWS CLI，請使用 `stop-cluster`操作。若要啟動已停止的叢集，請使用 `start-cluster` 操作。這兩個操作均使用 `--cluster-arn` 參數。
**參數：**
+ **--cluster-arn** - 必要項目。您要停止或啟動之彈性叢集的 ARN 識別符。
**Example — 使用 停止彈性叢集 AWS CLI**
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
下列程式碼會停止 ARN 為 的彈性叢集`arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2`。
彈性叢集必須處於作用中或可用狀態。
針對 Linux、macOS 或 Unix：
```
aws docdb-elastic stop-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
針對 Windows：
```
aws docdb-elastic stop-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
**Example — 使用 啟動彈性叢集 AWS CLI**
在下列範例中，將每個*使用者輸入預留位置*取代為您自己的資訊。
下列程式碼會以 的 ARN 啟動彈性叢集`arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2`。
彈性叢集目前必須停止。
針對 Linux、macOS 或 Unix：
```
aws docdb-elastic start-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
針對 Windows：
```
aws docdb-elastic start-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
------
## 您可以在已停止的彈性叢集上執行的操作
當叢集停止時，您無法修改 Amazon DocumentDB 彈性叢集的組態。您必須先啟動叢集，然後才能執行任何這類管理動作。
Amazon DocumentDB 只有在再次啟動後，才會將任何排定的維護套用至已停止的彈性叢集。七天後，Amazon DocumentDB 會自動啟動已停止的彈性叢集，使其不會落後維護狀態太久。當彈性叢集重新啟動時，您將再次開始支付叢集中的碎片費用。
當彈性叢集停止時，Amazon DocumentDB 不會執行任何自動備份，也不會延長備份保留期。
# 維護 Amazon DocumentDB 彈性叢集
**Topics**
+ [檢視待定的彈性叢集維護動作](#view-elastic-cluster-maintenance)
+ [彈性叢集引擎更新](#elastic-cluster-engine-updates)
+ [彈性叢集作業系統更新](#elastic-cluster-os-updates)
Amazon DocumentDB 會定期對 Amazon DocumentDB 彈性叢集資源執行維護。維護通常涉及資料庫引擎的更新 （彈性叢集維護） 或彈性叢集的基礎作業系統 (OS 更新）。資料庫引擎更新是必要的修補程式，包括資料庫引擎的安全性修正、錯誤修正和增強功能。雖然大多數作業系統修補程式都是選用的，但如果您有一段時間未套用，則可能需要修補程式並自動套用，以維護您的安全狀態。因此，我們建議您在 Amazon DocumentDB 彈性叢集可用時立即套用作業系統更新。
資料庫引擎修補程式需要您讓 Amazon DocumentDB 彈性叢集短暫離線。一旦可用，這些修補程式會自動排程在 Amazon DocumentDB 彈性叢集的近期排程維護時段套用。
彈性叢集有自己的個別維護時段。您已選擇不立即套用的彈性叢集修改會在維護時段期間套用。根據預設，當您建立彈性叢集時，Amazon DocumentDB 會為您的彈性叢集指派維護時段。您可以在建立彈性叢集時選擇維護時段。您也可以隨時修改維護時段，使符合您的業務排程或實務。我們通常會建議您選擇對應用程式影響最低的維護時段 (例如，在晚上或週末)。
## 檢視待定的彈性叢集維護動作
您可以使用 檢視您的彈性叢集是否可使用維護更新 AWS CLI。
如有更新可用，您可執行下列操作之一：
+ 延遲目前排程用於下一個維護時段的維護動作 （僅適用於作業系統修補程式）。
+ 立即套用維護動作。
+ 排程在下次的維護時段啟動維護動作。
+ 排程要在所選套用時段內啟動的維護動作。
維護時段會判斷待定的操作何時開始，但不限制這些操作的總執行時間。
使用下列 AWS CLI 操作來判斷待定的維護動作。列出所有待定的維護動作：
```
aws docdb-elastic list-pending-maintenance-actions
```
此操作的輸出如下所示 (JSON 格式）：
```
{
'ResourcePendingMaintenanceActions': [
{
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'ENGINE_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'string',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
},
],
'NextToken': 'string'
}
```
取得指定 上的待定維護動作 （如果有的話）`resourceArn`：
```
aws docdb-elastic get-pending-maintenance-action --resource-arn string-arn
```
此操作的輸出將會如下所示 (JSON 格式)。
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'ENGINE_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'string',
'CurrentApplyDate': 'string',
'Description': 'string'
}
]
}
}
```
參數：
+ `ResourceArn`- 套用待定維護動作之資源的 Amazon DocumentDB Amazon Resource Name (ARN)。
+ `Action`- 套用至資源的待定維護動作。
有效值：
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ `AutoAppliedAfterDate`- 此日期之後的第一個維護時段。在此情況下`NEXT_MAINTENANCE OPT_IN`會忽略 。
+ `ForcedApplyDate`- 無論維護時段為何都會套用。在此情況下`IMMEDIATE OPT_IN`， 會被忽略。
+ `OptInStatus`- 指定選擇加入請求類型的值，或復原選擇加入請求。無法復原 `IMMEDIATE` 類型的選擇使用請求。
有效值：
+ `IMMEDIATE`- 立即套用維護動作。
+ `NEXT_MAINTENANCE`- 在資源的下一個維護時段套用維護動作。
+ `APPLY_ON`- 在指定的套用日期套用維護動作，無論資源的下一個維護時段為何。
+ `UNDO_OPT_IN`- 取消任何現有的請求`NEXT_MAINTENANCE`或`APPLY_ON`選擇加入請求。
+ `CurrentApplyDate`- 如果opt-in-type為 則會顯示`APPLY_ON`。
+ `Description`- 維護動作的選項描述。
## 彈性叢集引擎更新
使用 Amazon DocumentDB，您可以選擇何時套用維護操作。您可以使用 來決定 Amazon DocumentDB 何時套用更新 AWS CLI。
套用待定的維護動作：
```
aws docdb-elastic apply-pending-maintenance-action
--resource-arn string-arn
--apply-action string-enum
--opt-in-type string-enum
[--apply-on string-date-range]
```
參數：
+ **--resource-arn**- 套用待定維護動作之資源的 Amazon DocumentDB Amazon Resource Name (ARN)。
+ **--apply-action**- 要套用至此資源的待定維護動作。
有效值：
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ **--opt-in-type**- 指定選擇加入請求類型的值，或復原選擇加入請求。無法復原 `IMMEDIATE` 類型的選擇使用請求。
有效值：
+ `IMMEDIATE`- 立即套用維護動作。
+ `NEXT_MAINTENANCE`- 在資源的下一個維護時段套用維護動作。
+ `APPLY_ON`- 在指定的套用日期套用維護動作，無論資源的下一個維護時段為何。
+ `UNDO_OPT_IN`- 取消任何現有的請求`NEXT_MAINTENANCE`或`APPLY_ON`選擇加入請求。
+ **[--apply-on]**- 如果opt-in-type為 則為必要`APPLY_ON`。格式：`yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm`（此選項使用 UTC 時間。 開始時間可以是未來任何時間，從最少 30 分鐘到最多 14 天，或對待定動作強制/套用日期，以較早者為準。 從開始到結束的時間範圍最短可達 30 分鐘，最長可達 8 小時。)
此操作的輸出如下所示 (JSON 格式）：
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'SECURITY_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'IMMEDIATE',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
}
}
```
參數：
+ `ResourceArn`- 套用待定維護動作之資源的 Amazon DocumentDB Amazon Resource Name (ARN)。
+ `Action`- 套用至資源的待定維護動作。
有效值：
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ `AutoAppliedAfterDate`- 此日期之後的第一個維護時段。在此情況下`NEXT_MAINTENANCE OPT_IN`會忽略 。
+ `ForcedApplyDate`- 無論維護時段為何都會套用。在此情況下`IMMEDIATE OPT_IN`， 會被忽略。
+ `OptInStatus`- 指定選擇加入請求類型的值，或復原選擇加入請求。無法復原 `IMMEDIATE` 類型的選擇使用請求。
有效值：
+ `IMMEDIATE`- 立即套用維護動作。
+ `NEXT_MAINTENANCE`- 在資源的下一個維護時段套用維護動作。
+ `APPLY_ON`- 在指定的套用日期套用維護動作，無論資源的下一個維護時段為何。
+ `UNDO_OPT_IN`- 取消任何現有的請求`NEXT_MAINTENANCE`或`APPLY_ON`選擇加入請求。
+ `CurrentApplyDate`- 如果opt-in-type為 則會顯示`APPLY_ON`。
+ `Description`- 維護動作的選項描述。
### 套用日期
每個維護動作都有各自的套用日期，您可以在描述待定維護動作時找到。當您從 讀取待定維護動作的輸出時 AWS CLI，會列出三個日期：
+ `CurrentApplyDate`- 將立即或在下一個維護時段套用維護動作的日期。如果維護是選用的，則此值可以是 null。
+ `ForcedApplyDate`- 自動套用維護的日期，與您的維護時段無關。
+ `AutoAppliedAfterDate`- 在叢集的維護時段期間套用維護的日期。
### 使用者建立的維護動作
身為 Amazon DocumentDBelastic 叢集使用者，您可以啟動叢集組態的更新。
**更新叢集主要密碼**
```
aws docdb-elastic update-cluster
--cluster-arn string-arn
[--admin-user-password string]
[--auth-type string-enum]
[--apply-method string-enum]
[--apply-on string-date-range]
#... other parameters of the API that follow here are not relevant for this configuration
```
參數：
+ **--cluster-arn**- 要套用維護動作之資源的 Amazon DocumentDB Amazon Resource Name (ARN)。
+ **[--admin-user-password]**- 與管理員使用者相關聯的密碼。
+ **[--auth-type]**- 用來決定在何處擷取用於存取彈性叢集之密碼的身分驗證類型。有效類型為 `PLAIN_TEXT`或 `SECRET_ARN`。
+ **[--apply-method]**- 指定所套用方法類型的值。允許的值為 `IMMEDIATE` 和 `APPLY_ON`。預設值為 `IMMEDIATE`。
+ **[--apply-on]**- 如果 `apply-method`是 則為必要`APPLY_ON`。格式：`yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm`（此選項使用 UTC 時間。 開始時間可以是未來任何時間，從最少 30 分鐘到最多 14 天。 從開始到結束的時間範圍最短可達 30 分鐘，最長可達 8 小時。)
此操作的輸出如下所示 (JSON 格式）：
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'MASTER_USER_PASSWORD_UPDATE',
'OptInStatus': 'APPLY_ON',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
}
}
```
### 變更 Amazon DocumentDB 維護時段
維護時段應落在使用量最低的時段，因此可能需要不時進行變更。只有在套用系統變更 （例如擴展儲存操作變更） 且需要中斷時，您的彈性叢集才會在此期間無法使用。它只能在進行必要變更所需的最短時間內無法使用。
預設值是從每個 Amazon Web Services 區域的 8 小時時段中隨機選取的 30 分鐘時段，該時段隨機發生在一週中的某一天。
若要變更維護時段，請參閱 [修改彈性叢集組態](elastic-managing.md#elastic-modify)。
## 彈性叢集作業系統更新
Amazon DocumentDB 彈性叢集偶爾需要作業系統更新。Amazon DocumentDB 會將作業系統升級至較新的版本，以改善資料庫效能和客戶的整體安全狀態。作業系統更新不會變更 Amazon DocumentDB 彈性叢集的叢集引擎版本。
Amazon DocumentDB 彈性叢集的大多數作業系統更新都是選用的，而且沒有要套用它們的設定日期。不過，如果您有一段時間沒有套用這些更新，它們最終可能會變成必要，並在叢集維護時段期間自動套用。這是為了協助維護資料庫的安全狀態。為了避免任何意外停機，建議您在 Amazon DocumentDB 彈性叢集可用時立即套用作業系統更新，並根據您的業務需求在方便的時間設定叢集維護時段。