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

# クラスターのエンジンバージョンへのパッチ更新の実行
<a name="db-cluster-version-upgrade"></a>

このセクションでは、 AWS マネジメントコンソール または を使用してパッチ更新をデプロイする方法について説明します AWS CLI。パッチ更新とは、同じエンジンバージョン内のアップデートです (たとえば、3.6 エンジンバージョンを新しい 3.6 エンジンバージョンにアップデートするなど)。すぐにアップグレードするか、クラスターの次回のメンテナンス期間中にアップデートできます。エンジンのアップグレードが必要かどうかを確認するには、[実施待ちのメンテナンスの確認](db-cluster-determine-pending-maintenance.md) を参照してください。更新を適用すると、クラスターでダウンタイムが生じることを理解しておいてください。

**注記**  
3.6 から 5.0 など、メジャーエンジンバージョンから別のエンジンバージョンにアップグレードする場合は、「[Amazon DocumentDB のインプレースメジャーバージョンアップグレード](docdb-mvu.md)」または「[を使用した Amazon DocumentDB クラスターのアップグレード AWS Database Migration Service](docdb-migration.versions.md)」を参照してください。メジャーバージョン一括アップグレードでは、ターゲットエンジンバージョンとして docdb 5.0 のみがサポートされます。

クラスターのエンジンバージョンの最新のパッチアップデートを取得するには、次の 2 つの構成要件があります。
+ クラスターステータスは *使用可能* でなければなりません。
+ クラスターが以前のエンジンバージョンで実行されている必要があります。

------
#### [ Using the AWS マネジメントコンソール ]

次の手順では、コンソールを使用して、パッチを適用し、クラスターのエンジンバージョンを最新のバージョンに更新します。すぐにアップグレードするか、クラスターの次のメンテナンスウィンドウ時に更新できます。

1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) で Amazon DocumentDB コンソールを開きます。

1. ナビゲーションペインで **[Clusters]** (クラスター) を選択してください。クラスターのリストで、アップグレードするクラスターの左側にあるボタンを選択します。クラスターのステータスは *使用可能* でなければなりません。
**ヒント**  
画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/docdb-menu-icon.png)) を選択します。

1. [**アクション**] メニューから、以下のいずれかのオプションを選択します。これらのメニューオプションは、選択したクラスターで最新のエンジンバージョンが実行されていない場合にのみ選択できます。  
![\[イメージ: Amazon DocumentDB アップグレードアクション\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
   + [**今すぐアップグレード**]　− 今すぐアップグレードプロセスが開始されます。最新のエンジンバージョンにアップグレードしている間、クラスターはしばらくオフラインになります。
   + [**次のウィンドウでアップグレード**] - クラスターの次のメンテナンスウィンドウ時にアップグレードを開始します。クラスターは、最新のエンジンバージョンにアップグレードしている間、しばらくオフラインになります。

1. 確認ウィンドウが開いたら、次のいずれかを選択します。
   + [**アップグレード**] - 前のステップで選択したスケジュールに基づき、クラスターを最新のエンジンバージョンにアップグレードします。
   + [**キャンセル**] - クラスターのエンジンアップグレードをキャンセルし、クラスターの最新エンジンバージョンを引き続き使用します。

------
#### [ Using the AWS CLI ]

 AWS CLI および `apply-pending-maintenance-action`オペレーションを使用して、以下のパラメータを指定して、クラスターにパッチ更新を適用できます。

**パラメータ**
+ **--resource-identifier** — 必須 アップグレードしようとしている Amazon DocumentDB クラスターの ARN。
+ **--apply-action** — 必須 以下の値を指定できます。クラスターのエンジンバージョンをアップグレードするには、`db-upgrade` を使用します。
  + **db-upgrade**
  + **system-update**
+ **--opt-in-type** — 必須 以下の値を指定できます。
  + `immediate` -メンテナンスアクションをすぐに適用します。
  + `next-maintenance` - 次回のメンテナンス期間中にメンテナンスアクションを適用します。
  + `undo-opt-in` -既存の `next-maintenance` オプトインリクエストをキャンセルします。

**Example**  
次の例では、`sample-cluster` のエンジンバージョンをエンジン 4.0.0 にパッチを更新します。  
Linux、macOS、Unix の場合:  

```
aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
   --apply-action db-upgrade \
   --opt-in-type immediate
```
Windows の場合:  

```
aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
   --apply-action db-upgrade ^
   --opt-in-type immediate
```
このオペレーションの出力は、次のようになります。  

```
{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "db-upgrade",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}
```

------