All Products
Search
Document Center

Cloud Backup:DescribeRecoverableOtsInstances

Last Updated:Aug 28, 2026

Queries the tables of a restorable Tablestore instance.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

CrossAccountType

string

No

Specifies whether data is backed up within the same Alibaba Cloud account or across Alibaba Cloud accounts. Valid values:

  • SELF_ACCOUNT: Data is backed up within the same Alibaba Cloud account.

  • CROSS_ACCOUNT: Data is backed up across Alibaba Cloud accounts.

CROSS_ACCOUNT

CrossAccountUserId

integer

No

The ID of the source Alibaba Cloud account that authorizes cross-account backup to the current account.

1440155109798732

CrossAccountRoleName

string

No

The name of the Resource Access Management (RAM) role created within the source Alibaba Cloud account and assigned to the current Alibaba Cloud account to authorize cross-account backup.

hbrcrossrole

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

14DC089E-5DD3-5028-AEDB-93D78E11DB2A

Success

boolean

Indicates whether the request was successful. Valid values:

  • true

  • false

true

Code

string

The response code. A value of 200 indicates success.

200

Message

string

The returned message. Returns "successful" for successful requests and an error message for failed requests.

successful

OtsInstances

array<object>

The restorable Tablestore instances and their tables.

object

The restorable Tablestore instances and their tables.

InstanceName

string

The name of the Tablestore instance that can be restored.

instancename

TableNames

array

The names of the tables in the Tablestore instance.

string

The names of the tables in the Tablestore instance.

["table1", "table2", "table3"]

Examples

Success response

JSON format

{
  "RequestId": "14DC089E-5DD3-5028-AEDB-93D78E11DB2A",
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "OtsInstances": [
    {
      "InstanceName": "instancename",
      "TableNames": [
        "[\"table1\", \"table2\", \"table3\"]"
      ]
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.