文档中心

缓存数据库 Redis 版

参数模板管理

批量应用参数模板

本文介绍如何将目标参数模板批量应用于多个实例。

前提条件

实例状态需为运行中。关于实例状态的更多详情，请参见实例状态。

已创建参数模板。具体操作，请参见创建参数模板。

注意事项

目标实例的数据库版本需与待应用的参数模板数据库版本一致。例如，参数模板支持的数据库版本为 Redis 6.0，那么该参数模板仅支持应用于 Redis 6.0 版本的实例。

如果需要应用的参数模板中包含了需要重启的参数，应用该参数模板后实例会重启。重启实例一般需要 30~60 秒完成，中间可能会有 1~2 次闪断，请谨慎操作。建议在业务低峰期执行该操作，并确保应用具备自动重连机制。

每个参数模板每次最多可批量应用于 20 个实例。

操作步骤

您可以选择以下任意一种方式来应用参数模板。

方法一：在实例列表页批量应用

在顶部菜单栏选择实例所属的项目和地域。

在实例列表页，勾选需要批量应用参数模板的目标实例。

说明

每个参数模板每次最多可批量应用于 20 个实例。

仅允许勾选实例状态为运行中且版本相同的实例。

在实例列表左下角选择 ... > 应用参数模板。

在弹出的批量应用参数模板面板中执行如下操作：

选择模板。

在已选实例区域确认需要应用该模板的实例信息（如实例名称、ID 和版本信息），并在参数模板区域勾选需要应用的模板。

单击右下角的下一步。

确认应用。

在确认信息区域，确认此次应用需要修改的参数信息（如参数名称、模板中的参数值、是否需要重启生效等），以及对应参数在已选实例中的当前值。

说明

如果需要应用的参数模板中包含了需要重启的参数，应用该参数模板后实例会重启。重启实例一般需要 30~60 秒完成，中间可能会有 1~2 次闪断，请谨慎操作。建议在业务低峰期执行该操作，并确保应用具备自动重连机制。

单击右下角的确定。

说明

单击确定后，会弹出批量任务已发起的弹窗。您可以在弹窗中执行如下操作：

查看本次参数模板应用任务的详细信息，包括任务进度，任务总数，单个任务的执行结果等。

针对执行失败的任务，您可以单击对应实例右侧操作列的重试，来重新发起针对该实例的参数模板应用任务。

单击右下角的批量重试，来重新发起针对所有执行失败实例的参数模板应用任务。

单击左下角的终止来终止本次批量应用参数模板操作，此时所有运行中或等待中的任务都会被终止。

单击右下角的确定，来关闭该弹窗。

方法二：在参数模板页批量应用

在顶部菜单栏选择实例所属的项目和地域。

在左侧导航栏中，选择 NoSQL 数据库 > Redis > 参数模板。

在参数模板页，根据业务需要在自定义模板或系统模板页签下找到需要应用的参数模板。

在目标参数模板右侧的操作列，单击应用到实例。

在弹出的应用参数模板到实例面板中执行如下操作：

选择实例。

在已选参数模板区域确认需要应用的模板信息（如模板名称、ID、适用版本、创建和修改时间等），并在下方的实例列表区域勾选需要应用该模板的实例。

说明

每个参数模板每次最多可批量应用于 20 个实例。

仅允许勾选实例状态为运行中，且与目标参数模板所适用版本相同的实例。

单击右下角的下一步。

确认应用。

在确认信息区域，确认此次应用需要修改的参数信息（如参数名称、模板中的参数值、是否需要重启生效等），以及对应参数在已选实例中的当前值。

说明

单击右下角的确定。

说明

单击确定后，会弹出批量任务已发起的弹窗。您可以在弹窗中执行如下操作：

查看本次参数模板应用任务的详细信息，包括任务进度，任务总数，单个任务的执行结果等。

针对执行失败的任务，您可以单击对应实例右侧操作列的重试，来重新发起针对该实例的参数模板应用任务。

单击右下角的批量重试，来重新发起针对所有执行失败实例的参数模板应用任务。

单击左下角的终止来终止本次批量应用参数模板操作，此时所有运行中或等待中的任务都会被终止。

单击右下角的确定，来关闭该弹窗。

后续操作

参数模板应用成功后，您可以在修改记录页签下，查看本次参数模板应用中所修改参数的修改记录，包括已修改参数的名称、修改前后的参数值、参数修改状态、修改时间等。具体操作步骤，请参见查看参数修改记录。

API	说明
ApplyParameterGroup	调用 ApplyParameterGroup 接口将应用参数模板到实例。