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

# 修改 ElastiCache 叢集
<a name="Clusters.Modify"></a>

除了從 ElastiCache 叢集新增或移除節點之外，有時您可能需要進行其他變更，例如新增安全群組、變更維護時段或參數群組。

建議您將維護時段落在使用量最低的時段。您可能需要不時進行調整。

當變更叢集的參數時，變更即會立即套用至叢集，或在叢集重新啟動之後套用。無論是變更叢集的參數群組本身或是叢集的參數群組內的參數值，均適用此情況。若要判斷何時套用特定參數變更，請參閱 [Memcached 專用參數](ParameterGroups.Engine.md#ParameterGroups.Memcached)和 資料表中**詳細資訊**欄**的變更生效**一節[Valkey 和 Redis OSS 參數](ParameterGroups.Engine.md#ParameterGroups.Redis)。如需重新啟動叢集節點的資訊，請參閱[重新啟動節點](nodes.rebooting.md)。

## 使用 ElastiCache AWS 管理主控台
<a name="Clusters.Modify.CON"></a>

**修改叢集**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/) 開啟 ElastiCache 主控台。

1. 從右上角的清單中，選擇您要修改的叢集所在的 AWS 區域。

1. 在導覽窗格中，選擇您要修改之叢集所執行的引擎。

   接著會出現所選引擎的叢集清單。

1. 在叢集清單中，針對您要修改的叢集，選擇其名稱。

1. 選擇 **Actions (動作)**，然後選擇 **Modify (修改)**。

   **Modify Cluster (修改叢集)** 視窗隨即出現。

1. 在 **Modify Cluster (修改叢集)** 視窗中，進行所需的修改。選項包括：
   + 描述
   + 叢集模式 – 若要將叢集模式從**停用**修改為**啟用**，您必須先將叢集模式設定為**相容**。

     相容模式可讓您的 Valkey 或 Redis OSS 用戶端使用啟用叢集模式和停用叢集模式進行連線。遷移所有 Valkey 或 Redis OSS 用戶端以使用啟用的叢集模式後，您就可以完成叢集模式組態，並將叢集模式設定為**已啟用**。
   + 引擎版本相容性
**重要**  
您可以升級到較新的引擎版本。如果您升級主要引擎版本 (例如從 5.0.6 升級到 6.0)，則需要選取與新引擎版本相容的參數群組系列。如需這項作業的詳細資訊，請參閱[ElastiCache 的版本管理](VersionManagement.md)。不過，您無法降級至舊版引擎，除非您刪除現有的叢集，並重新建立叢集。
   + VPC 安全群組
   + 參數群組
   + 節點類型
**注意**  
如果叢集使用 r6gd 系列中的節點類型，則只能從該系列中選擇不同的節點大小。如果從 r6gd 系列中選擇節點類型，則將自動啟用資料分層。如需詳細資訊，請參閱[資料分層](data-tiering.md)。
   + Multi-AZ
   + 自動容錯移轉 (僅適用於停用叢集模式)
   + 啟用自動備份
   + 備份節點 ID
   + 備份保留期間
   + 備份時段
   + SNS 通知的主題
   + Memcached 引擎版本相容性
   + Network type (網路類型)
**注意**  
如果您要從 IPv4 切換到 IPv6，則須選取或建立與 IPv6 相容的子網路群組。如需詳細資訊，請參閱[在 ElastiCache 中選擇網路類型](network-type.md)。
   + VPC 安全群組
   + 參數群組
   + 維護時段
   + SNS 通知的主題

   「**立即套用**」方塊僅適用於引擎版本和節點類型修改。若要立即套用變更，請選擇 **Apply Immediately (立即套用)** 核取方塊。如果未選擇此方塊，引擎版本的修改將於下次維護時段套用。其他修改 (例如變更維護時段) 則會立即套用。

**啟用/停用 Redis 的日誌交付**

1. 從叢集清單中選擇您要修改的叢集。請選擇**叢集名稱**而不是名稱旁邊的核取方塊。

1. 在**叢集詳細資訊**頁面上，選擇**日誌**索引標籤。

1. 若要啟用或停用慢速日誌，請選擇**啟用或停用******。

   如果您選擇 Enable (啟用)：

   1. 在 **Log format** (日誌格式) 下，選擇 **JSON** 或 **Text** (文字)。

   1. 在 **Log destination type** (日誌目的地類型) 下，選擇 **CloudWatch Logs** 或 **Kinesis Firehose**。

   1. 在**日誌目的地**下，您可以選擇**建立新的** ，然後輸入您的 CloudWatchLogs 日誌群組名稱或 Kinesis Data Firehose 串流名稱。您也可以選擇**選取現有**，然後選擇 CloudWatchLogs 日誌群組名稱或 Kinesis Data Firehose 串流名稱。

   1. 選擇 **啟用** 。

**若要變更 Redis 的組態：**

1. 選擇 **Modify** (修改)。

1. 在 **Log format** (日誌格式) 下，選擇 **JSON** 或 **Text** (文字)。

1. 在 **Destination Type (目的地類型)** 下，選擇 **CloudWatch Logs** 或 **Kinesis Firehose**。

1. 在 **Log destination** (日誌目的地) 下，選擇 **Create new** (新建)，然後輸入您的 CloudWatchLogs 日誌群組名稱或 Kinesis Data Firehose 串流名稱。或是選擇 **Select existing** (選取現有)，然後選擇您的 CloudWatchLogs 日誌群組名稱或 Kinesis Data Firehose 串流名稱。

## AWS CLI 搭配 ElastiCache 使用
<a name="Clusters.Modify.CLI"></a>

您可以使用 操作修改現有的叢集 AWS CLI `modify-cache-cluster`。若要修改叢集的組態值，請指定叢集 ID、要變更的參數以及參數的新值。下方範例會變更名稱為 `my-cluster` 之叢集的維護時段，並立即套用變更。

**重要**  
您可以升級至較新的 Memcached 引擎版本。如需這項作業的詳細資訊，請參閱[ElastiCache 的版本管理](VersionManagement.md)。不過，您無法降級至舊版引擎，除非您刪除現有的叢集，並重新建立叢集。

**重要**  
您可以升級至較新的 Valkey 或 Redis OSS 引擎版本。如果您將主要引擎版本升級，例如從 Redis OSS 5.0.6 升級至 Redis OSS 6.0，則需要選取與新引擎版本相容的參數群組系列。如需這項作業的詳細資訊，請參閱[ElastiCache 的版本管理](VersionManagement.md)。不過，您無法降級至舊版引擎，除非您刪除現有的叢集，並重新建立叢集。

若為 Linux、macOS 或 Unix：

```
aws elasticache modify-cache-cluster \
    --cache-cluster-id my-cluster \
    --preferred-maintenance-window sun:23:00-mon:02:00
```

針對 Windows：

```
aws elasticache modify-cache-cluster ^
    --cache-cluster-id my-cluster ^
    --preferred-maintenance-window sun:23:00-mon:02:00
```

`--apply-immediately` 參數僅適用於節點類型、引擎版本和叢集節點數的修改。如果您要立即套用其中任何變更，請使用 `--apply-immediately` 參數。如果您想將這些變更延期至下一個維護時段，請使用 `--no-apply-immediately` 參數。其他修改 (例如變更維護時段) 則會立即套用。

如需詳細資訊，請參閱適用於 ElastiCache AWS CLI 的 主題[https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html)。

## 使用 ElastiCache API
<a name="Clusters.Modify.API"></a>

您可以使用 ElastiCache API `ModifyCacheCluster` 作業修改現有的叢集。若要修改叢集的組態值，請指定叢集 ID、要變更的參數以及參數的新值。下方範例會變更名稱為 `my-cluster` 之叢集的維護時段，並立即套用變更。

**重要**  
您可以升級至較新的 Memcached 引擎版本。如需這項作業的詳細資訊，請參閱[ElastiCache 的版本管理](VersionManagement.md)。不過，您無法降級至舊版引擎，除非您刪除現有的叢集，並重新建立叢集。

**重要**  
您可以升級至較新的 Valkey 或 Redis OSS 引擎版本。如果您將主要引擎版本升級，例如從 Redis OSS 5.0.6 升級至 Redis OSS 6.0，則需要選取與新引擎版本相容的參數群組系列。如需這項作業的詳細資訊，請參閱[ElastiCache 的版本管理](VersionManagement.md)。不過，您無法降級至舊版引擎，除非您刪除現有的叢集，並重新建立叢集。

加上分行符號的用意是便於閱讀。

```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=ModifyCacheCluster
    &CacheClusterId=my-cluster
    &PreferredMaintenanceWindow=sun:23:00-mon:02:00
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20150901T220302Z
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Date=20150202T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20150901T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>
```

`ApplyImmediately` 參數僅適用於節點類型、引擎版本和叢集節點數的修改。如果您要立即套用其中任何變更，請將 `ApplyImmediately` 參數設為 `true`。如果您想將這些變更延期至下一個維護時段，請將 `ApplyImmediately` 參數設為 `false`。其他修改 (例如變更維護時段) 則會立即套用。

如需詳細資訊，請參閱 ElastiCache API 參考主題 [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html)。