本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 將 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)。
------