All Products
Search
Document Center

ApsaraDB for OceanBase:DescribeBackupSetDownloadLink

Last Updated:Apr 29, 2024

You can call this operation to query the link for downloading a backup set of OceanBase Database.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
InstanceIdstringYes

The ID of the OceanBase cluster.

ob317v4uif****
DownloadTaskIdstringYes

The ID of the download task corresponding to the target backup set.

1000002

Response parameters

ParameterTypeDescriptionExample
object

The return result of the request.

RequestIdstring

The ID of the request.

EE205C00-30E4-****-****-87E3A8A2AA0C
Dataobject

The returned data.

DownloadTaskIdlong

The ID of the download task corresponding to the target backup set.

1000002
DownloadTaskStatusstring

The status of the download task corresponding to the target backup set.

RUNNING
DownloadTaskCreateTimestring

The time when the download task corresponding to the target backup set was created.

2020-05-22T17:04:18
BackupRestorableTimestring

The restorable time of the backup set.

yyyy-MM-dd HH:mm:ss
BackupSetIdstring

The ID of the target backup set.

bak-4n****gacpa8
InternalUrlstring

The internal URL.

http://bucket.oss-region-internal.aliyuncs.com/xxxxx
UrlExpiredTimestring

The expiration time of the URL.

2024-01-04 17:39:49
UrlAliveTimelong

The validity period of the URL, in seconds.

3600

Examples

Sample success responses

JSONformat

{
  "RequestId": "EE205C00-30E4-****-****-87E3A8A2AA0C",
  "Data": {
    "DownloadTaskId": 1000002,
    "DownloadTaskStatus": "RUNNING",
    "DownloadTaskCreateTime": "2020-05-22T17:04:18",
    "BackupRestorableTime": "yyyy-MM-dd HH:mm:ss",
    "BackupSetId": "bak-4n****gacpa8",
    "InternalUrl": "http://bucket.oss-region-internal.aliyuncs.com/xxxxx",
    "UrlExpiredTime": "2024-01-04 17:39:49",
    "UrlAliveTime": 3600
  }
}

Error codes

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