本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 修改 ElastiCache 参数组
<a name="ParameterGroups.Modifying"></a>

**重要**  
您无法修改任何默认参数组。

您可以修改参数组中的某些参数值。这些参数值应用于与参数组关联的集群。有关参数值更改何时应用于参数组的更多信息，请参阅 [Valkey 和 Redis OSS 参数](ParameterGroups.Engine.md#ParameterGroups.Redis) 和 [Memcached 特定的参数](ParameterGroups.Engine.md#ParameterGroups.Memcached)。

## 修改参数组（控制台）
<a name="ParameterGroups.Modifying.CON"></a>

以下过程介绍了如何使用 ElastiCache 控制台更改 `cluster-enabled` 参数的值。您可以使用相同的过程来更改任意参数的值。

**使用 ElastiCache 控制台更改参数的值**

1. 登录 AWS 管理控制台 并打开 ElastiCache 控制台 ([https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/))。

1. 要查看所有可用的参数组列表，请在导航窗格左侧选择**Parameter Groups**。

1. 通过选择参数组名称左侧的框来选择要修改的参数组。

   屏幕底部将列出参数组的参数。您可能需要浏览列表才能查看所有参数。

1. 要修改一个或多个参数，请选择 **Edit Parameters**。

1. 在 **Edit Parameter Group:（编辑参数组：）**屏幕上，使用左箭头和右箭头滚动找到 `binding_protocol` 参数，然后在 **Value（值）**列中键入 `ascii`。

1. 选择**保存更改**。

1. 对于 Memcached，要查找您更改的参数名称，请参阅 [Memcached 特定的参数](ParameterGroups.Engine.md#ParameterGroups.Memcached)。如果参数更改在*重新启动* 生效，则重启使用此参数组的所有集群。有关更多信息，请参阅[重启集群](Clusters.html#Rebooting)。

1. 对于 Valkey 和 Redis OSS，要查找您更改的参数名称，请参阅[Valkey 和 Redis OSS 参数](ParameterGroups.Engine.md#ParameterGroups.Redis)。如果您的集群为 Valkey 和 Redis OSS（已禁用集群模式）集群并对以下参数进行了更改，则您必须重启集群中的节点：
   + activerehashing
   + 数据库

    有关更多信息，请参阅[重启节点](nodes.rebooting.md)。
**Valkey 或 Redis OSS（已启用集群模式）参数更改**  
如果要更改 Valkey 或 Redis OSS（已启用集群模式）集群上的以下参数，请按照随后的步骤操作。  
activerehashing
数据库
对于 Redis OSS，您可以创建集群的手动备份。请参阅[进行手动备份](backups-manual.md)。
请删除集群。请参阅[删除集群](Clusters.html#Delete)。
使用修改的参数组和备份还原集群，以便为新集群创建种子。请参阅[从备份还原到新缓存](backups-restoring.md)。
对其他参数的更改不需要执行此操作。



## 修改参数组 (AWS CLI)
<a name="ParameterGroups.Modifying.CLI"></a>

要使用 AWS CLI 更改参数值，请使用命令 `modify-cache-parameter-group`。

**Example**  
对于 Memcached，要查找您要更改的参数名称和允许的值，请参阅 [Memcached 特定的参数](ParameterGroups.Engine.md#ParameterGroups.Memcached)  
以下示例代码演示设置两个参数的值：参数组 `myMem14` 的 *chunk\$1size* 和 *chunk\$1size\$1growth\$1fact*。  
对于 Linux、macOS 或 Unix：  

```
aws elasticache modify-cache-parameter-group \
    --cache-parameter-group-name myMem14 \
    --parameter-name-values \
        ParameterName=chunk_size,ParameterValue=96 \
        ParameterName=chunk_size_growth_fact,ParameterValue=1.5
```
对于 Windows：  

```
aws elasticache modify-cache-parameter-group ^
    --cache-parameter-group-name myMem14 ^
    --parameter-name-values ^
        ParameterName=chunk_size,ParameterValue=96 ^
        ParameterName=chunk_size_growth_fact,ParameterValue=1.5
```
此命令的输出如下所示。  

```
{
    "CacheParameterGroupName": "myMem14"
}
```

**Example**  
对于 Valkey 和 Redis OSS，要查找您要更改的参数名称和允许的值，请参阅 [Valkey 和 Redis OSS 参数](ParameterGroups.Engine.md#ParameterGroups.Redis)  
以下示例代码演示设置两个参数的值：参数组 `myredis32-on-30` 的 *reserved-memory-percent* 和 *cluster-enabled*。我们将 *reserved-memory-percent* 设置为 `30`（30%）并将 *cluster-enabled* 设置为 `yes`，以便参数组可与 Valkey 或 Redis OSS（已启用集群模式）集群（复制组）搭配使用。  
对于 Linux、macOS 或 Unix：  

```
aws elasticache modify-cache-parameter-group \
    --cache-parameter-group-name myredis32-on-30 \
    --parameter-name-values \
        ParameterName=reserved-memory-percent,ParameterValue=30 \
        ParameterName=cluster-enabled,ParameterValue=yes
```
对于 Windows：  

```
aws elasticache modify-cache-parameter-group ^
    --cache-parameter-group-name myredis32-on-30 ^
    --parameter-name-values ^
        ParameterName=reserved-memory-percent,ParameterValue=30 ^
        ParameterName=cluster-enabled,ParameterValue=yes
```
此命令的输出如下所示。  

```
{
    "CacheParameterGroupName": "my-redis32-on-30"
}
```

有关更多信息，请参阅 [https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-parameter-group.html)。

要查找您更改的参数名称，请参阅[Valkey 和 Redis OSS 参数](ParameterGroups.Engine.md#ParameterGroups.Redis)。

 如果您的集群为 Valkey 和 Redis OSS（已禁用集群模式）集群并对以下参数进行了更改，则您必须重启集群中的节点：
+ activerehashing
+ 数据库

 有关更多信息，请参阅[重启节点](nodes.rebooting.md)。

**Valkey 或 Redis OSS（已启用集群模式）参数更改**  
如果要更改 Valkey 或 Redis OSS（已启用集群模式）集群上的以下参数，请按照随后的步骤操作。  
activerehashing
数据库
创建集群的手动备份。请参阅[进行手动备份](backups-manual.md)。
请删除集群。请参阅[删除集群](Clusters.html#Delete)。
使用修改的参数组和备份还原集群，以便为新集群创建种子。请参阅[从备份还原到新缓存](backups-restoring.md)。
对其他参数的更改不需要执行此操作。

## 修改参数组 (ElastiCache API)
<a name="ParameterGroups.Modifying.API"></a>

要使用 ElastiCache API 更改参数组的参数值，请使用 `ModifyCacheParameterGroup` 操作。

**Example**  
对于 Memcached，要查找您要更改的参数名称和允许的值，请参阅 [Memcached 特定的参数](ParameterGroups.Engine.md#ParameterGroups.Memcached)  
以下示例代码演示设置两个参数的值：参数组 `myMem14` 的 *chunk\$1size* 和 *chunk\$1size\$1growth\$1fact*。  

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=ModifyCacheParameterGroup
   &CacheParameterGroupName=myMem14
   &ParameterNameValues.member.1.ParameterName=chunk_size
   &ParameterNameValues.member.1.ParameterValue=96
   &ParameterNameValues.member.2.ParameterName=chunk_size_growth_fact
   &ParameterNameValues.member.2.ParameterValue=1.5
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &Version=2015-02-02
   &X-Amz-Credential=<credential>
```

**Example**  
对于 Valkey 和 Redis OSS，要查找您要更改的参数名称和允许的值，请参阅 [Valkey 和 Redis OSS 参数](ParameterGroups.Engine.md#ParameterGroups.Redis)  
以下示例代码演示设置两个参数的值：参数组 `myredis32-on-30` 的 *reserved-memory-percent* 和 *cluster-enabled*。我们将 *reserved-memory-percent* 设置为 `30`（30%）并将 *cluster-enabled* 设置为 `yes`，以便参数组可与 Valkey 或 Redis OSS（已启用集群模式）集群（复制组）搭配使用。  

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=ModifyCacheParameterGroup
   &CacheParameterGroupName=myredis32-on-30
   &ParameterNameValues.member.1.ParameterName=reserved-memory-percent
   &ParameterNameValues.member.1.ParameterValue=30
   &ParameterNameValues.member.2.ParameterName=cluster-enabled
   &ParameterNameValues.member.2.ParameterValue=yes
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &Version=2015-02-02
   &X-Amz-Credential=<credential>
```

有关更多信息，请参阅 [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheParameterGroup.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheParameterGroup.html)。

如果您的集群为 Valkey 和 Redis OSS（已禁用集群模式）集群并对以下参数进行了更改，则您必须重启集群中的节点：
+ activerehashing
+ 数据库

 有关更多信息，请参阅 [重启节点](nodes.rebooting.md)。

**Valkey 或 Redis OSS（已启用集群模式）参数更改**  
如果要更改 Valkey 或 Redis OSS（已启用集群模式）集群上的以下参数，请按照随后的步骤操作。  
activerehashing
数据库
创建集群的手动备份。请参阅[进行手动备份](backups-manual.md)。
请删除集群。请参阅[删除中的集群 ElastiCache](Clusters.Delete.md)。
使用修改的参数组和备份还原集群，以便为新集群创建种子。请参阅[从备份还原到新缓存](backups-restoring.md)。
对其他参数的更改不需要执行此操作。