クラスターへの Amazon DocumentDB インスタンスの追加

Using the AWS Management Console

次の手順に従い、Amazon DocumentDB コンソールを使用してクラスターのインスタンスを作成します。

にサインインし AWS Management Console、https://console.aws.amazon.com/docdb で Amazon DocumentDB コンソールを開きます。
ナビゲーションペインで [クラスター] を選択します。

ヒント
画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン () を選択します。
インスタンスの追加先のクラスターを選択するには、クラスター名の左にあるボタンを選択します。
[アクション] を選択し、[インスタンスの追加] を選択します。
[Add instance to: (インスタンスの追加先:)<cluster-name>] ページで、クラスターに追加する各インスタンスに対して以下の手順を繰り返します。最大数は 15 です。
1. インスタンス識別子 - このインスタンスの一意の識別子を入力するか、クラスター識別子に基づき Amazon DocumentDB でインスタンスを指定できるようにします。
  
  インスタンスの名前付けの制約:
  - 長さは [1 〜 63] 個の英字、数字、またはハイフンです。
  - 1 字目は英字である必要があります。
  - ハイフンを、文字列の最後に使用したり、2 つ続けて使用したりすることはできません。
  - Amazon RDS、Neptune、および Amazon DocumentDB のすべてのインスタンスで、ごと AWS アカウント、リージョンごとに一意である必要があります。
2. インスタンスクラス - ドロップダウンリストから、このインスタンスに必要なインスタンスタイプを選択します。
3. プロモーション枠 - ドロップダウンリストからインスタンスのプロモーション枠を選択するか、[指定なし] を選択して Amazon DocumentDB によってインスタンスのプロモーション枠が設定されるようにします。数値が小さいほど優先順位が高くなります。詳細については、「フェイルオーバーターゲットの制御」を参照してください。
4. インスタンスをさらに追加するには、[Add additional instances (追加のインスタンスを追加する)] を選択してステップ a、b、c を繰り返します。
オペレーションを完了します。
- インスタンスをクラスターに追加するには、[作成] を選択します。
- 操作をキャンセルするには、[キャンセル] を選択します。

インスタンスが作成されるまでに数分かかります。コンソールまたはを使用して、インスタンスのステータス AWS CLI を表示できます。詳細については、「インスタンスのステータスのモニタリング」を参照してください。

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 高可用性とレプリケーション」を参照してください。
--promotion-tier - オプション。このインスタンスのフェイルオーバー優先度の階層。0～15 の数値である必要があります。数値が小さいほど、優先順位が高くなります。詳細については、「フェイルオーバーターゲットの制御」を参照してください。

最初に、インスタンスを作成できるアベイラビリティーゾーンを決定します。

インスタンスを作成する前にアベイラビリティーゾーンを指定する場合は、次のコマンドを実行して 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"
        ]
    ]
]
                        
```
次に、リージョンで作成できるインスタンスクラスを決定します。

リージョンで利用可能なインスタンスクラスを確認するには、次のコマンドを実行します。出力から、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"
]
```

最後に、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:<accountID>:key/sample-key",
        "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "CACertificateIdentifier": "rds-ca-2019",
        "PromotionTier": 2,
        "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance-2"
    }
}

インスタンスが作成されるまでに数分かかります。コンソールまたはを使用して、インスタンスのステータス AWS CLI を表示できます。詳細については、「Amazon DocumentDB インスタンスのステータスのモニタリング」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

インスタンスのライフサイクル

インスタンスの説明

クラスターへの Amazon DocumentDB インスタンスの追加

ヒント