Restores the data of an ApsaraDB for Redis instance from a backup file to that instance.

Note If you call this operation, the existing data of the instance is overwritten by the data in the backup file. Proceed with caution. We recommend that you call the CreateInstance operation to create an instance. Then, you can restore data to the new instance.

Debugging

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 RestoreInstance

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

BackupId String Yes 78241****

The ID of the backup file. You can call the DescribeBackups operation to query the IDs of backup files.

InstanceId String Yes r-bp1zxszhcgatnx****

The ID of the instance.

RegionId String No cn-hangzhou

The region ID of the instance.

Response parameters

Parameter Type Example Description
RequestId String 8D0C0AFC-E9CD-47A4-8395-5C31BF9B****

The ID of the request.

Examples

Sample requests

https://r-kvstore.aliyuncs.com?Action=RestoreInstance
&InstanceId=r-bp1zxszhcgatnx****
&BackupId=78241****
&<Common request parameters>

Sample success responses

XML format

<RestoreInstanceResponse>
      <RequestId>8D0C0AFC-E9CD-47A4-8395-5C31BF9B****</RequestId>
</RestoreInstanceResponse>

JSON format

{
    "RequestId": "8D0C0AFC-E9CD-47A4-8395-5C31BF9B****"
}

Error codes

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