翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon DocumentDB インスタンスのライフサイクル
Amazon DocumentDB インスタンスのライフサイクルには、インスタンスの作成、変更、保守、アップグレード、バックアップと復元の実行、再起動、削除が含まれます。このセクションでは、これらのプロセスを完了する方法について説明します。
**Topics**
+ [インスタンスの追加](db-instance-add.md)
+ [インスタンスの説明](db-instance-view-details.md)
+ [インスタンスの変更](db-instance-modify.md)
+ [インスタンスの再起動](db-instance-reboot.md)
+ [インスタンスの削除](db-instance-delete.md)
AWS マネジメントコンソール または を使用して、新しい Amazon DocumentDB インスタンスを作成できます AWS CLI。クラスターにインスタンスを追加するには、クラスターが *使用可能* 状態になっている必要があります。停止しているクラスターにインスタンスを追加することはできません。クラスターが停止している場合は、最初にクラスターを起動し、クラスターが *使用可能* になるまで待ってから、インスタンスを追加します。詳細については、「[Amazon DocumentDB クラスターの停止と開始](db-cluster-stop-start.md)」を参照してください。
**注記**
コンソールを使用して Amazon DocumentDB クラスターを作成した場合、同時にインスタンスが自動的に作成されます。追加のインスタンスを作成する場合は、以下のいずれかの手順を使用します。
# クラスターへの 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)」を参照してください。
------
# Amazon DocumentDB インスタンスの説明
Amazon DocumentDB マネジメントコンソールまたは AWS CLI を使用して、接続エンドポイント、セキュリティグループ VPC、認証機関、Amazon DocumentDB インスタンスに関連するパラメータグループなどの詳細を確認できます。
------
#### [ Using the AWS マネジメントコンソール ]
AWS マネジメントコンソールを使用してインスタンスの詳細を確認するには、次の手順に従います。
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. インスタンスの一覧で、詳細を表示したいインスタンスの名前を選択します。インスタンスに関する情報は、次のグループに分けられます。
+ **概要** エンジンのバージョン、クラス、ステータス、保留中のメンテナンスなど、インスタンスに関する一般情報。
+ **Connectivity & Security** - **Connect** セクションには、[mongo] シェルまたはアプリケーションを使用してこのインスタンスに接続するための接続エンドポイントが一覧表示されます。[**セキュリティグループ**] セクションには、このインスタンスに関連付けられているセキュリティグループと、その VPC ID や説明が一覧表示されます。
+ **設定** - [**詳細**] セクションには、インスタンスの Amazon リソースネーム (ARN)、エンドポイント、ロール、クラス、認証機関など、インスタンスの設定とステータスが一覧表示されます。また、インスタンスのセキュリティとネットワーク設定、バックアップ情報も一覧表示されます。[**クラスターの詳細**] セクションには、このインスタンスが属するクラスターの詳細が表示されます。[**クラスターのインスタンス**] セクションには、クラスターに属するすべてのインスタンスが、各インスタンスのロールとクラスターパラメータグループのステータスとともに一覧表示されます。
**注記**
**クラスターの詳細** ヘッダーの次に **Modify** を選択することにより、インスタンスに関連付けられているクラスターを変更できます。詳細については、「[Amazon DocumentDB クラスターの変更](db-cluster-modify.md)」を参照してください。
+ [**モニタリング**] — このクラスターの Amazon CloudWatch Logs メトリクス。詳細については、「[Amazon DocumentDB と CloudWatch のモニタリング](cloud_watch.md)」を参照してください。
+ [**イベントとタグ**] — [**最近のイベント**] セクションには、このインスタンスの最近のイベントの一覧が表示されます。Amazon DocumentDB は、クラスター、インスタンス、スナップショット、セキュリティグループ、およびクラスターパラメータグループに関連するイベントのレコードを保持します。この情報には、各イベントに関連する日付、時刻、およびメッセージが含まれます。[**タグ**] セクションには、このクラスターにアタッチされているタグが一覧表示されます。詳細については、「[Amazon DocumentDB リソースへのタグ付け](tagging.md)」を参照してください。
------
#### [ Using the AWS CLI ]
を使用して Amazon DocumentDB インスタンスの詳細を表示するには AWS CLI、以下の例に示すように `describe-db-clusters` コマンドを使用します。詳細については、「*Amazon DocumentDB リソース管理 API リファレンス*」の「[https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html)」を参照してください。
**注記**
クラスターやインスタンスのライフサイクル管理などの特定の管理機能において、Amazon DocumentDB は Amazon RDS と共有される運用テクノロジーを使用します。`filterName=engine,Values=docdb` のフィルターパラメータは Amazon DocumentDB クラスターのみを返します。
1. **List all Amazon DocumentDB instances.**
次の AWS CLI コードは、リージョン内のすべての Amazon DocumentDB インスタンスの詳細を一覧表示します。
Linux、macOS、Unix の場合:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
Windows の場合:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **指定した Amazon DocumentDB インスタンスのすべての詳細を一覧表示する**
次のコードは `sample-cluster-instance` の詳細を一覧します。`--db-instance-identifier` パラメータにインスタンスの名前を含めると、出力はその特定のインスタンスの情報に制限されます。
Linux、macOS、Unix の場合:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
Windows の場合:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
このオペレーションの出力は、次のようになります。
```
{
"DBInstances": [
{
"DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
"DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"DBInstanceClass": "db.r5.large",
"DBInstanceStatus": "creating",
"AutoMinorVersionUpgrade": true,
"PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
"BackupRetentionPeriod": 1,
"StorageEncrypted": true,
"DBClusterIdentifier": "sample-cluster",
"EngineVersion": "3.6.0",
"AvailabilityZone": "us-east-1a",
"Engine": "docdb",
"PromotionTier": 2,
"DBInstanceIdentifier": "sample-cluster-instance",
"PreferredBackupWindow": "00:00-00:30",
"PubliclyAccessible": false,
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"Subnets": [
{
"SubnetIdentifier": "subnet-4e26d263",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-afc329f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-53ab3636",
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-991cb8d0",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-29ab1025",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupDescription": "default",
"SubnetGroupStatus": "Complete"
},
"PendingModifiedValues": {},
"KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
}
]
}
```
------
# 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)」を参照してください。
------
# Amazon DocumentDB インスタンスの再起動
ときどき、通常はメンテナンスのために、Amazon DocumentDB インスタンスを再起動する必要があります。クラスターに関連付けられたクラスターパラメータグループを変更するなど、特定の変更を行う場合は、変更を有効にするためにクラスター内のインスタンスを再起動する必要があります。 AWS マネジメントコンソール または を使用して、指定されたインスタンスを再起動できます AWS CLI。
インスタンスを再起動すると、データベースエンジンサービスが再起動されます。再起動により一時的に機能停止になります。その間、インスタンスのステータスは [`rebooting`] に設定されます。再起動が完了すると、Amazon DocumentDB イベントが作成されます。
インスタンスを再起動しても、フェイルオーバーは発生しません。Amazon DocumentDB クラスターをフェイルオーバーするには、 AWS マネジメントコンソール または AWS CLI オペレーション を使用します`failover-db-cluster`。詳細については、「[Amazon DocumentDB フェイルオーバー](failover.md)」を参照してください。
*available (利用可能)* 状態でないインスタンスを再起動することはできません。データベースは、以前の要求による変更、またはメンテナンスウィンドウのアクションなど、いくつかの理由で使用できない場合があります。インスタンスステータスの詳細については、「[Amazon DocumentDB インスタンスのステータスのモニタリング](monitoring_docdb-instance_status.md)」を参照してください。
------
#### [ Using the AWS マネジメントコンソール ]
次の手順では、コンソールを使用して指定するインスタンスを再起動します。
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. [**Actions (アクション)**]、[**Reboot (再起動)**] の順に選択し、[**Reboot (再起動)**] を選択して再起動を確認します。
インスタンスが再起動するまでには数分かかります。インスタンスを使用できるのは、そのステータスが [*available*] である場合のみです。コンソールまたは AWS CLIを使用して、インスタンスのステータスをモニタリングできます。詳細については、「[Amazon DocumentDB インスタンスのステータスのモニタリング](monitoring_docdb-instance_status.md)」を参照してください。
------
#### [ Using the AWS CLI ]
Amazon DocumentDB インスタンスを再起動するには、`reboot-db-instance` のパラメータとともに `--db-instance-identifier` のオペレーションを使用します。このパラメータは、再起動するインスタンスの識別子を指定します。
次のコードは、インスタンス `sample-instance` を再起動します。
**Example**
Linux、macOS、Unix の場合:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
Windows の場合:
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
このオペレーションによる出力は、次のようになります。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "rebooting",
"Endpoint": {
"Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"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": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
インスタンスが再起動するまでには数分かかります。インスタンスを使用できるのは、そのステータスが [*available*] である場合のみです。コンソールまたは AWS CLIを使用して、インスタンスのステータスをモニタリングできます。詳細については、「[Amazon DocumentDB インスタンスのステータスのモニタリング](monitoring_docdb-instance_status.md)」を参照してください。
------
# Amazon DocumentDB インスタンスの削除
Amazon DocumentDB インスタンスは、 AWS マネジメントコンソール または を使用して削除できます AWS CLI。インスタンスを削除するには、インスタンスが *使用可能* 状態である必要があります。停止しているインスタンスを削除することはできません。インスタンスを含む Amazon DocumentDB クラスターが停止している場合は、最初にクラスターを起動し、インスタンスが *使用可能* になるまで待ってから、インスタンスを削除します。詳細については、「[Amazon DocumentDB クラスターの停止と開始](db-cluster-stop-start.md)」を参照してください。
**注記**
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. クラスターナビゲーションボックスに、[**Cluster Identifier**]の列が表示されます。インスタンスは、以下のスクリーンショットのように、クラスターの下に表示されます。
![\[インスタンスがクラスター内にネストされている、クラスター識別子列の下のクラスターのリストを示すクラスターテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/choose-clusters.png)
1. 削除するインスタンスの左側にあるボックスをチェックします。
1. [**Actions (アクション)**] を選択して、[**Delete (削除)**] を選択します。
1. クラスターの最後のインスタンスを削除する場合:
+ **Create final cluster snapshot? (最終クラスタースナップショットを作成しますか?)** - クラスターを削除する前に最終スナップショットを作成する場合は、[**はい**] を選択します。それ以外の場合は [**いいえ**] を選択します。
+ **Final snapshot name (最終スナップショット名)** - 最終スナップショットを作成する場合は、作成した新しいクラスタースナップショットのクラスタースナップショットの識別子を入力します。
+ **Delete instance? ( インスタンスを削除しますか?)** - 削除を確定するには、[**delete entire cluster (クラスター全体を削除)**] というフレーズをフィールドに入力します。
1. クラスターの最後のインスタンスを削除しない場合:
+ **Delete instance? ( インスタンスを削除しますか?)** - 削除を確認するフレーズ [**delete me (これを削除する)**] をフィールドに入力します。
1. [**Delete (削除)**] を選択して、インスタンスを削除します。
インスタンスが削除されるまでに数分かかります。インスタンスのステータスをモニタリングするには、「[Amazon DocumentDB インスタンスのステータスのモニタリング](monitoring_docdb-instance_status.md)」を参照してください。
------
#### [ Using the AWS CLI ]
次の手順では、 AWS CLIを使用して Amazon DocumentDB インスタンスを削除します。
1. **最初に、Amazon DocumentDB クラスター内のインスタンスの数を決定します。**
クラスター内のインスタンスの数を判断するには、以下のように `describe-db-clusters` コマンドを実行します。
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
このオペレーションによる出力は、次のようになります。
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **Amazon DocumentDB クラスターに複数のインスタンスがある場合。**
指定された Amazon DocumentDB インスタンスを削除するには、次に示すように `delete-db-instance` のパラメータを用いて `--db-instance-identifier` のコマンドを使用します。インスタンスが削除されるまでに数分かかります。インスタンスのステータスをモニタリングするには、「[Amazon DocumentDB インスタンスのステータスのモニタリング](monitoring_docdb-instance_status.md)」を参照してください。
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
このオペレーションによる出力は、次のようになります。
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "deleting",
"Endpoint": {
"Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"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": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
1. **削除するインスタンスが Amazon DocumentDB クラスターの最後のインスタンスである場合。**
Amazon DocumentDB クラスター内の最後のインスタンスを削除すると、そのクラスターと、そのクラスターに関連付けられた自動スナップショットと継続バックアップも削除されます。
クラスターの最後のインスタンスを削除するには、クラスターを削除し、オプションで最終スナップショットを作成します。詳細については、「[Amazon DocumentDB クラスターの削除](db-cluster-delete.md)」を参照してください。
------
## 削除保護
Amazon DocumentDB クラスターの最後のインスタンスを削除すると、クラスターと、そのクラスターに関連付けられた自動スナップショットと継続バックアップも削除されます。Amazon DocumentDB は、 AWS マネジメントコンソール または を使用して削除オペレーションを実行するかどうかにかかわらず、クラスターの削除保護を適用します AWS CLI。削除保護が有効になっている場合、クラスターを削除することはできません。
削除に対する保護が有効化されているクラスターを削除するには、まずクラスターを変更して削除保護を無効化する必要があります。詳細については、「[Amazon DocumentDB クラスターの削除](db-cluster-delete.md)」を参照してください。