本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon DocumentDB 執行個體生命週期
Amazon DocumentDB 執行個體的生命週期包括建立、修改、維護和升級、執行備份和還原、重新啟動和刪除執行個體。本節提供如何完成這些程序的相關資訊。
**Topics**
+ [新增執行個體](db-instance-add.md)
+ [描述執行個體](db-instance-view-details.md)
+ [修改執行個體](db-instance-modify.md)
+ [重新啟動執行個體](db-instance-reboot.md)
+ [刪除執行個體](db-instance-delete.md)
您可以使用 AWS 管理主控台 或 建立新的 Amazon DocumentDB 執行個體 AWS CLI。若要將執行個體新增至叢集，叢集必須處於*可用*狀態。您無法將執行個體新增至已停止的叢集。如果叢集已停止，請先啟動叢集，等待叢集變成*可用*，然後新增執行個體。如需詳細資訊，請參閱[停止和啟動 Amazon DocumentDB 叢集](db-cluster-stop-start.md)。
**注意**
如果您使用主控台建立 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. 若要選擇要新增執行個體的叢集，請選取叢集名稱左側的按鈕。
1. 選擇 **Actions (動作)**，然後選擇 **Add instances (新增執行個體)**。
1. 在 **Add instance to: (新增執行個體至)** 頁面，針對您想要加到叢集的每個執行個體重複以下步驟。您最多可以有 15 個。
1. **執行個體識別符** — 您可以為此執行個體輸入唯一識別符，或允許 Amazon DocumentDB 根據叢集識別符提供執行個體識別符。
執行個體命名限制：
+ 長度為 【1-63】 個字母、數字或連字號。
+ 第一個字元必須是字母。
+ 不能以連字號結尾，或包含兩個連續連字號。
+ 對於每個區域每個 Amazon RDS、Neptune 和 Amazon DocumentDB 的所有執行個體 AWS 帳戶，必須是唯一的。
1. **執行個體類別** — 從下拉式清單中，選擇您想要用於此執行個體的執行個體類型。
1. **提升方案**：從下拉式清單中，選擇執行個體的提升方案，或選擇*無偏好設定*，以允許 Amazon DocumentDB 為您的執行個體設定提升方案。數字越小表示優先順序越高。如需詳細資訊，請參閱[控制容錯移轉目標](failover.md#failover-target_control)。
1. 若要新增更多執行個體，請選擇 **Add additional instances (新增其他執行個體)**，然後重複步驟 a、b 和 c。
1. 完成操作。
+ 若要新增執行個體到您的叢集，請選擇 **Create (建立)**。
+ 若要取消操作，請選擇 **Cancel (取消)**。
建立執行個體需要幾分鐘才能完成。您可以使用 主控台或 AWS CLI 來檢視執行個體的狀態。如需詳細資訊，請參閱[監控執行個體的狀態](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
使用 `create-db-instance` AWS CLI 操作搭配下列參數，為您的叢集建立主要執行個體。
+ **--db-instance-class** – 必要。執行個體的運算與記憶體容量，例如 `db.m4.large`。並非所有執行個體類別都可在所有 中使用 AWS 區域。
+ **--db-instance-identifier** – 必要。識別執行個體的字串。
執行個體命名限制條件：
+ 長度為 【1-63】 個字母、數字或連字號。
+ 第一個字元必須是字母。
+ 不能以連字號結尾，或包含兩個連續連字號。
+ 對於每個區域每個 Amazon RDS、Neptune 和 Amazon DocumentDB 的所有執行個體 AWS 帳戶，必須是唯一的。
+ **--engine** – 必要。必須為 `docdb`。
+ **--availability-zone** — 選用。要在其中建立執行個體的可用區域。使用此參數尋找不同可用區域中的執行個體，以提高容錯能力。如需詳細資訊，請參閱[Amazon DocumentDB 高可用性和複寫](replication.md)。
+ **--promotion-tier** — 選用。此執行個體的容錯移轉優先順序方案。必須介於 0 和 15 之間，數字越小優先順序越高。如需詳細資訊，請參閱[控制容錯移轉目標](failover.md#failover-target_control)。
1. **首先，決定您可以在其中建立執行個體的可用區域。**
如果您想要在建立執行個體之前指定可用區域，請執行下列命令來判斷哪些可用區域可供您的 Amazon DocumentDB 叢集使用。
針對 Linux、macOS 或 Unix：
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
針對 Windows：
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
此操作的輸出將會如下所示。
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **其次，判定您可以在區域中建立哪些執行個體類別。 **
若要判斷您區域中可用的執行個體類別，請執行以下命令。從輸出中，為您要新增至 Amazon DocumentDB 叢集的執行個體選擇執行個體類別。
針對 Linux、macOS 或 Unix：
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
針對 Windows：
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
此操作的輸出將會如下所示。
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **最後，將執行個體新增至 Amazon DocumentDB 叢集。**
若要將執行個體新增至 Amazon DocumentDB 叢集，請執行下列命令。
針對 Linux、macOS 或 Unix：
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance-2 \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.xlarge \
--engine docdb
```
針對 Windows：
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster ^
--db-instance-identifier sample-instance-2 ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.xlarge ^
--engine docdb
```
此操作的輸出將會如下所示。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.xlarge",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
建立執行個體需要幾分鐘才能完成。您可以使用 主控台或 AWS CLI 來檢視執行個體的狀態。如需詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
# 描述 Amazon DocumentDB 執行個體
您可以使用 Amazon DocumentDB 管理主控台或 查看 AWS CLI 連線端點、安全群組 VPCs、憑證授權單位和與 Amazon DocumentDB 執行個體相關的參數群組等詳細資訊。
------
#### [ Using the AWS 管理主控台 ]
若要使用 AWS 管理主控台檢視執行個體的詳細資訊，請依照下列步驟操作。
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. 在叢集導覽方塊中，您會看到**叢集識別符**欄。您的執行個體會列在叢集下，類似於下面的螢幕擷取畫面。
![\[叢集資料表顯示叢集識別符欄下的叢集清單，其中執行個體巢狀在叢集內。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/choose-clusters.png)
1. 在執行個體清單中，選擇您要查看其詳細資訊的執行個體名稱。執行個體的相關資訊分為下列群組：
+ **摘要** - 執行個體的一般資訊，包括引擎版本、類別、狀態和任何待定維護。
+ **連線與安全性** — **Connect** 區段列出使用 mongo shell 或 應用程式連線至此執行個體的連線端點。**Seucirty Groups (安全群組)** 區段會列出與此執行個體相關聯的安全群組，以及其 VPC ID 和描述。
+ **組態** - **詳細資訊**區段列出執行個體的組態和狀態，包括執行個體的 Amazon Resource Name (ARN)、端點、角色、類別和憑證授權單位。它也會列出執行個體的安全性和網路設定，以及備份資訊。**Cluster details (叢集詳細資訊)** 區段會列出此執行個體所屬叢集的詳細資訊。**Cluster instances (叢集執行個體)** 區段會列出屬於您叢集的所有執行個體，當中每個執行個體的角色和叢集參數群組狀態。
**注意**
您可以透過選取叢集詳細資訊標頭旁的**修改**，來修改與執行個體相關聯的叢集。 ****如需詳細資訊，請參閱[修改 Amazon DocumentDB 叢集](db-cluster-modify.md)。
+ **監控** - 此執行個體的 CloudWatch Logs 指標。如需詳細資訊，請參閱[使用 CloudWatch 監控 Amazon DocumentDB](cloud_watch.md)。
+ **事件和標籤** — **最近事件**區段列出此執行個體的最近事件。Amazon DocumentDB 會保留與叢集、執行個體、快照、安全群組和叢集參數群組相關的事件記錄。此資訊包括與每個事件相關聯的日期、時間和訊息。**Tags (標籤)** 區段會列出連接至此叢集的標籤。如需詳細資訊，請參閱[標記 Amazon DocumentDB 資源](tagging.md)。
------
#### [ Using the AWS CLI ]
若要使用 檢視 Amazon DocumentDB 執行個體的詳細資訊 AWS CLI，請使用 `describe-db-clusters`命令，如以下範例所示。如需詳細資訊，請參閱《*Amazon DocumentDB Resource Management API 參考*[https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html)》中的 。
**注意**
對於特定管理功能，例如叢集和執行個體生命週期管理，Amazon DocumentDB 會利用與 Amazon RDS 共用的操作技術。`filterName=engine,Values=docdb` 篩選條件參數只會傳回 Amazon DocumentDB 叢集。
1. **列出所有 Amazon DocumentDB 執行個體。**
下列 AWS CLI 程式碼列出區域中所有 Amazon DocumentDB 執行個體的詳細資訊。
針對 Linux、macOS 或 Unix：
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
針對 Windows：
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **列出指定 Amazon DocumentDB 執行個體的所有詳細資訊**
以下程式碼會列出 `sample-cluster-instance` 的詳細資訊。將 `--db-instance-identifier` 參數加入執行個體名稱會將輸出限制為該特定執行個體的資訊。
針對 Linux、macOS 或 Unix：
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
針對 Windows：
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
此操作的輸出如下所示：
```
{
"DBInstances": [
{
"DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
"DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"DBInstanceClass": "db.r5.large",
"DBInstanceStatus": "creating",
"AutoMinorVersionUpgrade": true,
"PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
"BackupRetentionPeriod": 1,
"StorageEncrypted": true,
"DBClusterIdentifier": "sample-cluster",
"EngineVersion": "3.6.0",
"AvailabilityZone": "us-east-1a",
"Engine": "docdb",
"PromotionTier": 2,
"DBInstanceIdentifier": "sample-cluster-instance",
"PreferredBackupWindow": "00:00-00:30",
"PubliclyAccessible": false,
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"Subnets": [
{
"SubnetIdentifier": "subnet-4e26d263",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-afc329f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-53ab3636",
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-991cb8d0",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-29ab1025",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupDescription": "default",
"SubnetGroupStatus": "Complete"
},
"PendingModifiedValues": {},
"KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
}
]
}
```
------
# 修改 Amazon DocumentDB 執行個體
您可以使用 AWS 管理主控台 或 來修改 Amazon DocumentDB 執行個體 AWS CLI。若要修改執行個體，執行個體必須處於*可用*狀態。您無法修改已停止的執行個體。如果叢集已停止，請先啟動叢集，等待執行個體變成*可用*，然後進行所需的修改。如需詳細資訊，請參閱[停止和啟動 Amazon DocumentDB 叢集](db-cluster-stop-start.md)。
------
#### [ Using the AWS 管理主控台 ]
若要使用主控台修改特定 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. 在叢集導覽方塊中，您會看到**叢集識別符**欄。您的執行個體會列在叢集下，類似於下面的螢幕擷取畫面。
![\[叢集資料表顯示叢集識別符欄下的叢集清單，其中執行個體巢狀在叢集內。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/choose-clusters.png)
1. 勾選您要修改之執行個體左側的方塊。
1. 選擇 **Actions (動作)**，然後選擇 **Modify (修改)**。
1. 在 **Modify instance: (修改執行個體：<執行個體-名稱>** 窗格中，進行您想要的變更。您可進行下列變更。
+ **執行個體規格** — 執行個體識別符和類別。執行個體識別符命名限制：
+ **執行個體識別符** — 為 AWS 帳戶 目前區域中 擁有的所有執行個體輸入唯一的名稱。執行個體識別符必須包含 【1-63】 個英數字元或連字號、以字母做為第一個字元，且不能以連字號結尾或包含兩個連續連字號。
+ **執行個體類別** — 從下拉式功能表中，選取 Amazon DocumentDB 執行個體的執行個體類別。如需詳細資訊，請參閱[管理執行個體類別](db-instance-classes.md)。
+ **憑證授權機構** — 此執行個體的伺服器憑證。如需詳細資訊，請參閱[更新您的 Amazon DocumentDB TLS 憑證](ca_cert_rotation.md)。
+ **容錯移轉** — 在容錯移轉期間，具有最高提升層的執行個體將提升為主要執行個體。如需詳細資訊，請參閱[Amazon DocumentDB 容錯移轉](failover.md)。
+ **維護** — 將待定修改或修補程式套用至叢集中執行個體的維護時段。
1. 完成後，請選擇 **Continue (繼續)** 以查看變更的摘要。
1. 確認變更後，即可立即套用，或是在下一個維護時段在 **Scheduling of modifications (修改的排程)** 下套用。選擇 **Modify Instance (修改執行個體)**，以儲存變更。或者，您可以選擇 **Cancel (取消)** 以捨棄變更。
套用您的變更需要幾分鐘的時間才會完成。您只能使用狀態為*可用*的執行個體。您可以使用主控台或 AWS CLI監控執行個體的狀態。如需詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
若要使用 修改特定 Amazon DocumentDB 執行個體 AWS CLI，請使用 `modify-db-instance`搭配下列參數。如需詳細資訊，請參閱 [ ModifyDBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html)。以下程式碼將執行個體 `sample-instance` 的執行個體類別修改為 `db.r5.large`。
**Parameters**
+ **--db-instance-identifier** – 必要。要修改的執行個體識別碼。
+ **--db-instance-class** — 選用。執行個體的新運算和記憶體容量；例如 `db.r5.large`。並非所有執行個體類別都可在所有 中使用 AWS 區域。如果您修改執行個體類別，則會在變更期間發生中斷。除非此請求`ApplyImmediately`指定為 true，否則變更會在下一個維護時段套用。
+ **--apply-immediately** 或 **--no-apply-immediately** — 選用。指定這項修改應立即套用，或等到下一次維護時段才套用。若省略此參數，則會在下一次維護時段進行修改。
**Example**
針對 Linux、macOS 或 Unix：
```
aws docdb modify-db-instance \
--db-instance-identifier sample-instance \
--db-instance-class db.r5.large \
--apply-immediately
```
針對 Windows：
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-instance ^
--db-instance-class db.r5.large ^
--apply-immediately
```
此操作的輸出將會如下所示。
```
{
"DBInstances": [
{
"DBInstanceIdentifier": "sample-instance-1",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "modifying",
"Endpoint": {
"Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-01-10T22:18:55.921Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1a",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
"PendingModifiedValues": {
"DBInstanceClass": "db.r5.large"
},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
]
}
```
套用您的修改需要幾分鐘的時間才會完成。您只能使用狀態為*可用*的執行個體。您可以使用 AWS 管理主控台 或 監控執行個體的狀態 AWS CLI。如需詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
# 重新啟動 Amazon DocumentDB 執行個體
有時，您可能需要重新啟動 Amazon DocumentDB 執行個體，通常是基於維護原因。如果您進行某些變更，例如變更與叢集相關聯的叢集參數群組，則必須重新啟動叢集中的執行個體讓變更生效。您可以使用 AWS 管理主控台 或 重新啟動指定的執行個體 AWS CLI。
重新啟動執行個體，將重新啟動資料庫引擎服務。重新啟動會導致暫時中斷，在此期間，執行個體狀態會設定為 `rebooting`。重新啟動完成時，會建立 Amazon DocumentDB 事件。
重新啟動執行個體不會導致容錯移轉。若要容錯移轉 Amazon DocumentDB 叢集，請使用 AWS 管理主控台 或 AWS CLI 操作 `failover-db-cluster`。如需詳細資訊，請參閱[Amazon DocumentDB 容錯移轉](failover.md)。
如果執行個體不是*可用*狀態，就無法重新啟動執行個體。資料庫無法使用可能由多種原因導致，例如，先前要求的修改，或維護時段的動作。如需執行個體狀態的詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS 管理主控台 ]
以下程序會重新啟動您使用主控台指定的執行個體。
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/choose-clusters.png)
1. 勾選您要重新啟動之執行個體左側的方塊。
1. 選擇**Actions (動作)**、選擇 **Reboot (重新啟動)**，然後選擇 **Reboot (重新啟動)** 以確認重新啟動。
執行個體重新啟動需要幾分鐘的時間來完成。您只能使用狀態為*可用*的執行個體。您可以使用主控台或 AWS CLI監控執行個體的狀態。如需詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
若要重新啟動 Amazon DocumentDB 執行個體，請使用 `reboot-db-instance`操作搭配 `--db-instance-identifier` 參數。此參數會指定要重新啟動之執行個體的識別符。
以下程式碼會重新啟動執行個體 `sample-instance`。
**Example**
針對 Linux、macOS 或 Unix：
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
針對 Windows：
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
此操作的輸出將會如下所示。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "rebooting",
"Endpoint": {
"Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
執行個體重新啟動需要幾分鐘的時間來完成。您只能使用狀態為*可用*的執行個體。您可以使用主控台或 AWS CLI監控執行個體的狀態。如需詳細資訊，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
# 刪除 Amazon DocumentDB 執行個體
您可以使用 AWS 管理主控台 或 刪除 Amazon DocumentDB 執行個體 AWS CLI。若要刪除執行個體，執行個體必須處於*可用*狀態。您無法刪除已停止的執行個體。如果包含執行個體的 Amazon DocumentDB 叢集已停止，請先啟動叢集，等待執行個體變成*可用*，然後刪除執行個體。如需詳細資訊，請參閱[停止和啟動 Amazon DocumentDB 叢集](db-cluster-stop-start.md)。
**注意**
Amazon DocumentDB 會將所有資料存放在叢集磁碟區中。資料會保留在該叢集磁碟區中，即使您移除叢集中的所有執行個體也一樣。如果您需要再次存取資料，可以隨時新增執行個體至叢集，並從您上次離開的位置繼續操作。
------
#### [ Using the AWS 管理主控台 ]
下列程序會使用主控台刪除指定的 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. 在叢集導覽方塊中，您會看到**叢集識別符**欄。您的執行個體會列在叢集下，類似於下面的螢幕擷取畫面。
![\[叢集資料表顯示叢集識別符欄下的叢集清單，其中執行個體巢狀在叢集內。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/choose-clusters.png)
1. 勾選您要刪除之執行個體左側的方塊。
1. 選取 **Actions (動作)**，然後選擇 **Delete (刪除)**。
1. 如果您要刪除叢集中的最後一個執行個體：
+ **Create final cluster snapshot? (建立最終叢集快照？)** — 如果您想要在刪除叢集之前建立最終快照，請選擇**是**。否則請選擇**否**。
+ **最終快照名稱** — 如果您選擇建立最終快照，請輸入所建立新叢集快照的叢集快照識別符。
+ **Delete instance? (刪除 執行個體？)** — 在欄位中輸入**刪除整個叢集**的片語，以確認刪除。
1. 如果您不是刪除叢集中的最後一個執行個體：
+ **Delete instance? (刪除 執行個體？)** — 在欄位中輸入刪除**我**以確認刪除的片語。
1. 選取 **Delete (刪除)** 以刪除執行個體。
刪除執行個體需要幾分鐘的時間。若要監控執行個體的狀態，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
------
#### [ Using the AWS CLI ]
下列程序會使用 刪除 Amazon DocumentDB 執行個體 AWS CLI。
1. **首先，判斷您的 Amazon DocumentDB 叢集中有多少執行個體：**
若要判斷叢集中有多少執行個體，請執行 `describe-db-clusters` 命令，如下所示。
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
此操作的輸出將會如下所示。
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **如果您的 Amazon DocumentDB 叢集中有多個執行個體：**
若要刪除指定的 Amazon DocumentDB 執行個體，請使用 `delete-db-instance`命令搭配 `--db-instance-identifier` 參數，如下所示。刪除執行個體需要幾分鐘的時間。若要監控執行個體的狀態，請參閱[監控 Amazon DocumentDB 執行個體的狀態](monitoring_docdb-instance_status.md)。
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
此操作的輸出將會如下所示。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "deleting",
"Endpoint": {
"Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
1. **如果您要刪除的執行個體是 Amazon DocumentDB 叢集中的最後一個執行個體： **
如果您刪除 Amazon DocumentDB 叢集中的最後一個執行個體，您也會刪除該叢集，以及與該叢集相關聯的自動快照和持續備份。
若要刪除叢集中的最後一個執行個體，您可以刪除該叢集並選擇性地建立最終快照。如需詳細資訊，請參閱[刪除 Amazon DocumentDB 叢集](db-cluster-delete.md)。
------
## 刪除保護
刪除 Amazon DocumentDB 叢集的最後一個執行個體也會刪除叢集，以及與該叢集相關聯的自動快照和持續備份。無論您是使用 AWS 管理主控台 或 執行刪除操作，Amazon DocumentDB 都會對叢集強制執行刪除保護 AWS CLI。如果已啟用刪除保護，您就無法刪除叢集。
若要刪除已啟用刪除保護的叢集，您必須先修改叢集並停用刪除保護。如需詳細資訊，請參閱[刪除 Amazon DocumentDB 叢集](db-cluster-delete.md)。