You can call this operation to upgrade the minor version of an ApsaraDB for Redis instance.

For more information about how to perform the corresponding operation in the console, see Upgrade the minor version.

The method and time required for upgrading the minor version vary with the architecture of an instance:

  • For the cluster edition, read/write splitting edition, or standard disaster recovery edition, the instance is upgraded during cross-server migration. The upgrade duration depends on the data volume. The instance may be disconnected within 30 seconds and become read-only within 60 seconds.
  • For the standard non-disaster recovery edition, the instance is upgraded on the local server. The upgrade takes effect within 5 minutes and has no impact on the ApsaraDB for Redis service. If the resources of the local server are insufficient, cross-server migration is required. The impact is the same as that for the cluster edition.
Note We recommend that you upgrade the version of an instance during off-peak hours and ensure that your application supports automatic reconnection.


You can call this operation in OpenAPI Explorer without the need to manually calculate the signature. After you call the operation, OpenAPI Explorer can automatically generate SDK example code.

Request parameters

Parameter Type Required Example Description
InstanceId String Yes r-bp1xxxxxxxxxxxxx

The ID of the instance for which you want to upgrade the minor version.

Action String No ModifyInstanceMinorVersion

The operation that you want to perform. Set this parameter to ModifyInstanceMinorVersion.

Minorversion String No latest_version

The target minor version to which you want to upgrade the instance. Default value: latest_version.

EffectTime String No 0

The time when the minor version is upgraded. Valid values:

  • 0: upgrades the minor version immediately.
  • 1: upgrades the minor version in the maintenance window.

Default value: 0.

AccessKeyId String No Lxxxxxxxxxxxxxxw

The AccessKey ID that Alibaba Cloud provides for you to access services.

Response parameters

Parameter Type Example Description
RequestId String 28761557-0B33-41DF-AEEB-322DFF960395

The ID of the request.


Sample request
? Action=ModifyInstanceMinorVersion
&<Common request parameters>

Sample success response

XML format


JSON format


Error codes

For more information, see Error codes.