DescribeOtsTableSnapshots - Hybrid Backup Recovery - Alibaba Cloud Documentation Center

Queries the details about Tablestore instances that are backed up.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
StartTime	long	No	The start time of the backup. This value must be a UNIX timestamp. Unit: seconds.	1611109271630
EndTime	long	No	The end time of the backup. This value must be a UNIX timestamp. Unit: seconds.	1652068250881
SnapshotIds	array	No	The list of snapshot IDs.
	string	No	The list of snapshot IDs.	s-00047mxg17p26****3c
OtsInstances	array	No	The list of Tablestore instances that are backed up.
	object	No	The list of Tablestore instances that are backed up.
InstanceName	string	No	The name of the Tablestore instance.	instancename
TableNames	array	No	The names of the tables in the Tablestore instance.
	string	No	The names of the tables in the Tablestore instance.	tablename
Limit	integer	No	The maximum number of rows that you want the current query to return.	100
NextToken	string	No	The token that is required to obtain the next page of backup snapshots.	caeba0bbb2be03f84eb48b699f0a****

Response parameters

Parameter	Type	Description	Example
	object	The reponse doby.
RequestId	string	The ID of the request.	09376812-6290-5E36-B504-E8010D72D1F0
Success	boolean	Indicates whether the call is successful. true: The call is successful. false: The call fails.	true
Code	string	The HTTP status code. The status code 200 indicates that the call is successful.	200
Message	string	The message that is returned. If the call is successful, "successful" is returned. If the call fails, an error message is returned.	successful
Limit	integer	The number of backup snapshots that are displayed on the current page.	10
Snapshots	array	The list of backup snapshots.
	object	The list of backup snapshots.
Status	string	The status of the backup job. Valid values: COMPLETE: The backup job is completed. PARTIAL_COMPLETE: The backup job is partially completed. FAILED: The backup job has failed.	COMPLETE
SnapshotHash	string	The hash value of the backup snapshot.	f2fe...
VaultId	string	The ID of the backup vault that stores the backup snapshot.	v-00030j*******sn
BackupType	string	The backup type. Valid value: COMPLETE, which indicates full backup.	COMPLETE
CreateTime	long	The time when the Tablestore instance was created. This value is a UNIX timestamp. Unit: seconds.	1607436917
ActualBytes	string	The actual amount of backup snapshots after duplicates are removed. Unit: bytes.	0
SourceType	string	The type of the data source. Valid values: ECS_FILE: backup snapshots for Elastic Compute Service (ECS) files OSS: backup snapshots for Object Storage Service (OSS) buckets NAS: backup snapshots for Apsara File Storage NAS file systems OTS_TABLE: backup snapshots for Tablestore instances	OTS_TABLE
BytesTotal	long	The total amount of data. Unit: bytes.	0
CompleteTime	long	The time when the backup snapshot was completed. This value is a UNIX timestamp. Unit: seconds.	1642496679
Retention	long	The retention period of the backup snapshot.	730
CreatedTime	long	The time when the backup snapshot was created. This value is a UNIX timestamp. Unit: seconds.	1642496679
ParentSnapshotHash	string	The hash value of the parent backup snapshot.	f2fe..
StartTime	long	The start time of the backup snapshot. This value is a UNIX timestamp. Unit: seconds.	1642496543
UpdatedTime	long	The time when the backup snapshot was updated. This value is a UNIX timestamp. Unit: seconds.	1642496679
SnapshotId	string	The ID of the backup snapshot.	s-00047mxg17p26*****b
JobId	string	The ID of the backup job.	job-00030j3chkt******2
InstanceName	string	The name of the Tablestore instance.	instancename
TableName	string	The name of the table in the Tablestore instance.	table2
RangeStart	long	The time when the backup job started. This value is a UNIX timestamp. Unit: seconds.	1642492553038
RangeEnd	long	The time when the backup job ended. This value is a UNIX timestamp. Unit: seconds.	1642521709966
NextToken	string	The token that is required to obtain the next page of backup snapshots.	caeba0bbb2be03f84eb48b699f0a

Examples

Sample success responses

JSONformat

{
  "RequestId": "09376812-6290-5E36-B504-E8010D72D1F0",
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "Limit": 10,
  "Snapshots": [
    {
      "Status": "COMPLETE",
      "SnapshotHash": "f2fe...",
      "VaultId": "v-00030j*******sn",
      "BackupType": "COMPLETE",
      "CreateTime": 1607436917,
      "ActualBytes": "0",
      "SourceType": "OTS_TABLE",
      "BytesTotal": 0,
      "CompleteTime": 1642496679,
      "Retention": 730,
      "CreatedTime": 1642496679,
      "ParentSnapshotHash": "f2fe..",
      "StartTime": 1642496543,
      "UpdatedTime": 1642496679,
      "SnapshotId": "s-00047mxg17p26*****b",
      "JobId": "job-00030j3chkt******2",
      "InstanceName": "instancename",
      "TableName": "table2",
      "RangeStart": 1642492553038,
      "RangeEnd": 1642521709966
    }
  ],
  "NextToken": "caeba0bbb2be03f84eb48b699f0a"
}

Error codes

For a list of error codes, visit the Service error codes.