Amazon DocumentDB インスタンスの変更

Amazon DocumentDB インスタンスは、 AWS Management Console または を使用して変更できます AWS CLI。インスタンスを変更するには、インスタンスが使用可能な状態である必要があります。停止しているインスタンスを変更することはできません。クラスターが停止している場合は、最初にクラスターを起動し、インスタンスが使用可能になるまで待ってから、必要な変更を加えます。詳細については、「Amazon DocumentDB クラスターの停止と開始」を参照してください。

Using the AWS Management Console

コンソールを使用して特定の Amazon DocumentDB インスタンスを変更するには、以下の手順を実行します。

1. にサインインし AWS Management Console、https://console.aws.amazon.com/docdb で Amazon DocumentDB コンソールを開きます。

2. ナビゲーションペインで [クラスター] を選択します。

   ヒント

   画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン () を選択します。

3. クラスターナビゲーションボックスに、[Cluster Identifier]の列が表示されます。インスタンスは、以下のスクリーンショットのように、クラスターの下に表示されます。

   

4. 変更するインスタンスの左側にあるボックスをチェックします。

5. [アクション] を選択してから、[変更] を選択します。

6. [インスタンスの変更: <instance-name>] ペインで、必要な変更を行います。以下の変更を行うことができます。

   • インスタンス仕様 - インスタンス識別子とクラス。インスタンス識別子の命名制約:

     • インスタンス識別子 — 現在のリージョンで が所有するすべてのインスタンス AWS アカウント に固有の名前を入力します。インスタンス識別子は [1 — 63] 英数字またはハイフンを使用し、最初の文字に文字を使用します。最後の文字をハイフンにすることはできず、ハイフンを 2 つ続けて使用することもできません。

     • インスタンスクラス — ドロップダウンメニューから、Amazon DocumentDB インスタンスのためのインスタンスクラスを選択します。詳細については、「インスタンスクラスの管理」を参照してください。

   • 認証機関 - このインスタンスのサーバー証明書。詳細については、「Amazon DocumentDB TLS 証明書の更新」を参照してください。

   • フェイルオーバー - フェイルオーバーにより、昇格階層が最も高いインスタンスがプライマリに昇格されます 詳細については、「Amazon DocumentDB フェイルオーバー」を参照してください。

   • メンテナンス - 保留中の変更またはパッチをクラスター内のインスタンスに適用するメンテナンスウィンドウ。

7. 完了したら、[続行] を選択して変更の概要を表示します。

8. 変更を確認したら、直ちに、あるいは、[変更のスケジューリング] の下にある次のメンテナンスウィンドウ中に適用することができます。[インスタンスの変更] を選択して、変更を保存します。または、[キャンセル] を選択して変更を破棄することもできます。

変更が適用されるまでに数分かかります。インスタンスを使用できるのは、そのステータスが [available] である場合のみです。コンソールまたは AWS CLI を使用して、インスタンスのステータスをモニタリングできます。詳細については、「Amazon DocumentDB インスタンスのステータスのモニタリング」を参照してください。

Using the AWS CLI

を使用して特定の Amazon DocumentDB インスタンスを変更するには AWS CLI、以下のパラメータmodify-db-instanceを指定して を使用します。詳細については、「ModifyDBInstance」を参照してください。次のコードは、sample-instance インスタンスのインスタンスクラスを db.r5.large に変更します。

パラメータ

• --db-instance-identifier — 必須。変更するインスタンスの識別子。

• --db-instance-class - オプション。インスタンスの新しいコンピューティング能力とメモリ容量 (例: db.r5.large)。すべてのインスタンスクラスがすべての AWS リージョン で利用できるわけではありません。インスタンスクラスを変更すると、変更中に機能停止が発生します。ApplyImmediately がこのリクエストの [true] として指定されない限り、変更は次のメンテナンスウィンドウ中に適用されます。

• --apply-immediately または --no-apply-immediately - オプション。この修正をすぐに適用するか、次のメンテナンスウィンドウまで待機するか指定します。このパラメータを省略した場合、次のメンテナンスウィンドウ中に変更が実行されます。

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"
            ]
        }
    ]
}

変更が適用されるまでに数分かかります。インスタンスを使用できるのは、そのステータスが [available] である場合のみです。 AWS Management Console または を使用して、インスタンスのステータスをモニタリングできます AWS CLI。詳細については、「Amazon DocumentDB インスタンスのステータスのモニタリング」を参照してください。