ApsaraDB for Redis allows you to modify specific instance parameters. The instance parameters that can be modified vary with engine version and instance architecture. This topic describes how to modify instance parameters.


Specific parameters are not supported in earlier minor versions. If your instance runs an earlier minor version, the following error message may be displayed when you set the parameters. You must update your instance to the latest minor version. For more information, see Update the minor version.

Figure 1. Outdated minor version prompt
Outdated minor version prompt


  1. Log on to the ApsaraDB for Redis console and go to the Instances page. In the top navigation bar, select the region in which the instance is deployed. Then, find the instance and click its ID.
  2. In the left-side navigation pane, click System Parameters.
  3. Modify one or more parameters.
    Three methods are available for parameter modification. For more information about the parameters, see Supported parameters.
    Warning After you submit a modification to a specific parameter, the instance is restarted. During the restart, the instance may experience second-accurate transient connections. Proceed with caution. Before you modify a parameter, check the Restart and Take Effect column of the parameter to make sure that an instance restart is not required for the modification to take effect.
    • Modify a single parameter for the instance.
      1. On the System Parameters page, find the parameter that you want to modify and click Modify in the Actions column.
      2. Click OK.
    • Modify multiple parameters for the instance.
      1. Click Batch Modify.
      2. Find the parameters that you want to modify and modify the parameter values in the Running Value column.
      3. Then, click Modify.
    • Import parameters from a file for modification.
      To apply the parameter configurations of an instance to the current instance, you can use this method. Before you apply the parameter configurations to the current instance, go to the System Parameters page of the source ApsaraDB for Redis instance and click Download parameters in the upper-right corner to download the parameter configuration file.
      Note These two instances must use the same engine version and instance architecture. Otherwise, specific parameter modifications cannot take effect. For example, the query_cache_enabled parameter is supported only by performance-enhanced instances of the ApsaraDB for Redis Enhanced Edition (Tair). If the current instance is of another series type or architecture, the imported configuration for this parameter cannot take effect. For more information, see Performance-enhanced instances.
      1. Click Import from File.
      2. In the Batch Import panel, click Import parameters from a file for modification to upload the downloaded file.
      3. In the Parameter Details section, check and select the displayed parameters.
        Note You can turn on Display Only Changed Parameters to filter out parameters whose values are not changed.
      4. Click Modify.

Related API operations

Operation Description
DescribeParameters Queries the configuration and operational parameters of an ApsaraDB for Redis instance.
ModifyInstanceConfig Modifies parameters of an ApsaraDB for Redis instance.