本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 管理 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. 編輯您要變更的欄位，然後選取**修改叢集**。
**注意**
或者，您可以前往**叢集**頁面，勾選**叢集**旁的方塊，選擇**動作**，然後選擇**修改**，以存取修改叢集對話方塊。
------
#### [ 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** (監控) 索引標籤。
下列監控類別會顯示來自 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. 在**刪除「叢集名稱」彈性叢集中？** 對話方塊，選擇**刪除**。
刪除叢集需要幾分鐘的時間。若要監控叢集的狀態，請參閱[監控 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)。
------