Upgrades 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 to upgrade the minor version vary based on the architecture of an instance:

  • For cluster instances, read/write splitting instances, and standard instances, use cross-server migration to upgrade the kernel versions of the instances. Standard instances must be deployed in the zones that support zone-disaster recovery. 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 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 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 instances in 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.


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 No 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 region ID of the resource.

EffectiveTime String No 0

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

  • 0: upgrades the minor version immediately. This is the default value.
  • 1: 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-322DFF960395

The ID of the request.


Sample requests

&<Common request parameters>

Sample success responses

XML format


JSON format

	"RequestId": "28761557-0B33-41DF-AEEB-322DFF960395"

Error codes

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