翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon DocumentDB インスタンスの変更
Amazon DocumentDB インスタンスは、 AWS マネジメントコンソール または を使用して変更できます AWS CLI。インスタンスを変更するには、インスタンスが *使用可能* 状態である必要があります。停止しているインスタンスを変更することはできません。クラスターが停止している場合は、最初にクラスターを起動し、インスタンスが*使用可能*になるまで待ってから、必要な変更を加えます。詳細については、「[Amazon DocumentDB クラスターの停止と開始](db-cluster-stop-start.md)」を参照してください。
------
#### [ 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. クラスターナビゲーションボックスに、[**Cluster Identifier**]の列が表示されます。インスタンスは、以下のスクリーンショットのように、クラスターの下に表示されます。
![\[インスタンスがクラスター内にネストされている、クラスター識別子列の下のクラスターのリストを示すクラスターテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/choose-clusters.png)
1. 変更するインスタンスの左側にあるボックスをチェックします。
1. [**アクション**] を選択してから、[**変更**] を選択します。
1. [**インスタンスの変更: **] ペインで、必要な変更を行います。以下の変更を行うことができます。
+ **インスタンス仕様** - インスタンス識別子とクラス。インスタンス識別子の命名制約:
+ **インスタンス識別子** — 現在のリージョンで が所有するすべてのインスタンス AWS アカウント に一意の名前を入力します。インスタンス識別子は [1 — 63] 英数字またはハイフンを使用し、最初の文字に文字を使用します。最後の文字をハイフンにすることはできず、ハイフンを 2 つ続けて使用することもできません。
+ **インスタンスクラス** — ドロップダウンメニューから、Amazon DocumentDB インスタンスのためのインスタンスクラスを選択します。詳細については、「[インスタンスクラスの管理](db-instance-classes.md)」を参照してください。
+ **認証機関** - このインスタンスのサーバー証明書。詳細については、「[Amazon DocumentDB TLS 証明書の更新](ca_cert_rotation.md)」を参照してください。
+ **フェイルオーバー** - フェイルオーバーにより、昇格階層が最も高いインスタンスがプライマリに昇格されます 詳細については、「[Amazon DocumentDB フェイルオーバー](failover.md)」を参照してください。
+ **メンテナンス** - 保留中の変更またはパッチをクラスター内のインスタンスに適用するメンテナンスウィンドウ。
1. 完了したら、[**続行**] を選択して変更の概要を表示します。
1. 変更を確認したら、直ちに、あるいは、[**変更のスケジューリング**] の下にある次のメンテナンスウィンドウ中に適用することができます。[**インスタンスの変更**] を選択して、変更を保存します。または、[**キャンセル**] を選択して変更を破棄することもできます。
変更が適用されるまでに数分かかります。インスタンスを使用できるのは、そのステータスが [*available*] である場合のみです。コンソールまたは AWS CLIを使用して、インスタンスのステータスをモニタリングできます。詳細については、「[Amazon DocumentDB インスタンスのステータスのモニタリング](monitoring_docdb-instance_status.md)」を参照してください。
------
#### [ Using the AWS CLI ]
を使用して特定の Amazon DocumentDB インスタンスを変更するには AWS CLI、次のパラメータ`modify-db-instance`を指定して を使用します。詳細については、「[ModifyDBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html)」を参照してください。次のコードは、`sample-instance` インスタンスのインスタンスクラスを `db.r5.large` に変更します。
**パラメータ**
+ **--db-instance-identifier** — 必須。変更するインスタンスの識別子。
+ **--db-instance-class** - オプション。インスタンスの新しいコンピューティング能力とメモリ容量 (例: `db.r5.large`)。すべてのインスタンスクラスがすべての AWS リージョンで利用できるわけではありません。インスタンスクラスを変更すると、変更中に機能停止が発生します。`ApplyImmediately` がこのリクエストの [true] として指定されない限り、変更は次のメンテナンスウィンドウ中に適用されます。
+ **--apply-immediately** または **--no-apply-immediately** - オプション。この修正をすぐに適用するか、次のメンテナンスウィンドウまで待機するか指定します。このパラメータを省略した場合、次のメンテナンスウィンドウ中に変更が実行されます。
**Example**
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 マネジメントコンソール または を使用してモニタリングできます AWS CLI。詳細については、「[Amazon DocumentDB インスタンスのステータスのモニタリング](monitoring_docdb-instance_status.md)」を参照してください。
------