Upgrades the minor version of an ApsaraDB for Redis instance.

You can also upgrade the minor version in the ApsaraDB for Redis console. For more information, see Upgrade the minor version.

The method and time required to upgrade the minor version vary based on the architecture of an instance:

  • If you are using cluster instances, read/write splitting instances, or standard instances, use cross-server migration to upgrade the kernel versions of the instances. The upgrade duration depends on the amount of data. The instance may be disconnected for less than 30 seconds and become read-only for less than 60 seconds.
  • For the standard instances that do not support disaster recovery, the instances are upgraded on the local server. The upgrade takes effect within five minutes and has no impact on the ApsaraDB for Redis service. If the resources of local servers are insufficient, cross-server migration is required to upgrade the kernel version. In this scenario, the impact of the upgrade is the same as that for the cluster instances.
Note We recommend that you upgrade the version of an instance during off-peak hours and ensure that your application supports automatic reconnection.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyInstanceMinorVersion

The operation that you want to perform. Set the value to ModifyInstanceMinorVersion.

InstanceId String Yes r-bp1zxszhcgatnx****

The ID of the instance.

Minorversion String No latest_version

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

RegionId String No cn-hangzhou

The ID of the region where the instance is deployed.

EffectiveTime String No Immediately

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

  • Immediately: immediately upgrades the minor version. This is the default value.
  • MaintainTime: upgrades the minor version in the maintenance window.
Note You can call the ModifyInstanceMaintainTime to modify the maintenance window of an ApsaraDB for Redis instance.

Response parameters

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

The ID of the request.


Sample requests

&<Common request parameters>

Sample success responses

XML format


JSON format

    "RequestId": "28761557-0B33-41DF-AEEB-322DFF96****"

Error codes

For a list of error codes, visit the API Error Center.