本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 對叢集的引擎版本執行修補程式更新
<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 作為目標引擎版本。

取得叢集引擎版本的最新修補程式更新有兩種組態需求：
+ 叢集狀態必須為*「可用」*。
+ 叢集必須執行舊版的引擎。

------
#### [ 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/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。

1. 從 **Actions (動作)** 功能表選擇下列其中一個選項。您選擇的叢集必須不是執行最新的引擎版本，這些功能表選項才可供選取。  
![\[影像：Amazon DocumentDB 升級動作\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
   + **立即升級** - 立即啟動升級程序。您的叢集會離線一段時間，讓叢集升級到最新的引擎版本。
   + **在下一個時段升級** - 在叢集的下一個維護時段啟動升級程序。您的叢集在升級到最新的引擎版本時，會離線一段時間。

1. 當確認視窗開啟時，請選擇下列其中一項：
   + **升級** - 根據上一個步驟中選擇的排程，將叢集升級至最新的引擎版本。
   + **Cancel**—取消叢集的引擎升級，並繼續執行叢集目前的引擎版本。

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

您可以使用 AWS CLI 和 `apply-pending-maintenance-action`操作搭配下列參數，將修補程式更新套用至叢集。

**Parameters**
+ **--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"
            }
        ]
    }
}
```

------