翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# クラスターへの 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/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。
1. インスタンスの追加先のクラスターを選択するには、クラスター名の左にあるボタンを選択します。
1. [**アクション**] を選択し、[**インスタンスの追加**] を選択します。
1. [**Add instance to: (インスタンスの追加先:)**] ページで、クラスターに追加する各インスタンスに対して以下の手順を繰り返します。最大数は 15 です。
1. **インスタンス識別子** - このインスタンスの一意の識別子を入力するか、クラスター識別子に基づき Amazon DocumentDB でインスタンスを指定できるようにします。
インスタンスの名前付けの制約:
+ 長さは [1 〜 63] 個の英字、数字、またはハイフンです。
+ 1 字目は英字である必要があります。
+ ハイフンで終わることも、2 つのハイフンを連続して含むこともできません。
+ Amazon RDS、Neptune、Amazon DocumentDB のすべてのインスタンスで AWS アカウント、リージョンごとに一意である必要があります。
1. **インスタンスクラス** - ドロップダウンリストから、このインスタンスに必要なインスタンスタイプを選択します。
1. **プロモーション枠** - ドロップダウンリストからインスタンスのプロモーション枠を選択するか、[*指定なし*] を選択して Amazon DocumentDB によってインスタンスのプロモーション枠が設定されるようにします。数値が小さいほど優先順位が高くなります。詳細については、「[フェイルオーバーターゲットの制御](failover.md#failover-target_control)」を参照してください。
1. インスタンスをさらに追加するには、[**Add additional instances (追加のインスタンスを追加する)**] を選択してステップ a、b、c を繰り返します。
1. オペレーションを完了します。
+ インスタンスをクラスターに追加するには、[**作成**] を選択します。
+ 操作をキャンセルするには、[**キャンセル**] を選択します。
インスタンスが作成されるまでに数分かかります。コンソールまたは を使用して 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] 個の英字、数字、またはハイフンです。
+ 1 字目は英字である必要があります。
+ ハイフンで終わることも、2 つのハイフンを連続して含むこともできません。
+ 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)」を参照してください。
------