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

# 修改 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\_size* 和 *chunk\_size\_growth\_fact*。  
对于 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\_size* 和 *chunk\_size\_growth\_fact*。  

```
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)。
对其他参数的更改不需要执行此操作。