Amazon DocumentDB インスタンスの変更 - Amazon DocumentDB

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon DocumentDB インスタンスの変更

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

Using the AWS Management Console

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

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

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

    ヒント

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

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

    DocumentDB clusters list showing two clusters with their identifiers and roles.

  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

AWS CLI を使用して特定の Amazon DocumentDB インスタンスを変更するには、以下のパラメータを用いて 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 インスタンスのステータスのモニタリング」を参照してください。