全部產品
Search
文件中心

Data Management:DescribeDownloadBackupSetStorageInfo - 查看下載備份組的儲存資訊

更新時間:Dec 02, 2025

查看下載備份組的儲存資訊。

介面說明

適用引擎

  • RDS MySQL(雲端硬碟系列)

  • RDS PostgreSQL

  • PolarDB MySQL 版

  • MongoDB

相關功能文檔

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

dbs:DescribeDownloadBackupSetStorageInfo

get

*BackupPlan

acs:dbs:{#regionId}:{#accountId}:backupplan/{#BackupPlanId}

請求參數

名稱

類型

必填

描述

樣本值

RegionCode

string

執行個體所在地區 ID。

cn-hangzhou

Duration

string

下載目標為 URL 時,設定連結有效時間長度。

  • 預設 URL 有效時間長度為 2 小時(7200 秒)。

  • 有效時間長度範圍可設定 5 分鐘(300 秒)~1 天(86400 秒)。

  • 請轉化為秒(s)後傳入該值,例如設定連結有效時間長度為 5 分鐘時,傳入 300。

300

InstanceName

string

執行個體 ID。

說明

如果您填寫了 InstanceName,也需填寫 BackupSetId

rm-uf6qqf569n435****

TaskId

string

下載任務 ID。

  • 如果不填寫任務 TaskId,則需要填寫 BackupSetIdInstanceName

  • 您可在單擊目標執行個體中的備份恢複,在備份下載頁簽下查看任務 ID

dt-s0ugzak9****

BackupSetId

string

備份組 ID。

30****

ClusterName

string

僅 MongoDB 依賴,分區叢集的叢集名

dds-example

返回參數

名稱

類型

描述

樣本值

object

傳回值如下。

RequestId

string

請求 ID。

44B8C2F5-919D-5D29-BCD5-DEB03467****

ErrCode

string

錯誤碼。

DBS.ParamIsInValid

Success

string

是否執行成功。傳回值:

  • true:執行成功

  • false:執行失敗

true

ErrMessage

string

錯誤資訊。

Argument: regionCode Must not be empty

Code

string

錯誤碼。

DBS.ParamIsInValid

Message

string

錯誤資訊。

Argument: regionCode Must not be empty

Data

object

返回資料如下。

PublicUrl

string

備份組公網下載地址。

http://dbs-137383785969****-cn-hangzhou-1iv12nblw****.oss-cn-hangzhou.aliyuncs.com/dt-u7u4bufa****/dbs_target_file_path/test_456

PrivateUrl

string

備份組私網下載地址。

http://dbs-137383785969****-cn-hangzhou-1iv12nblw****.oss-cn-hangzhou-internal.aliyuncs.com/dt-u7u4bufa****/dbs_target_file_path/test_123

ExpirationTime

integer

連結有效期間。

說明

傳回值為時間戳記形式。

1661329050

樣本

正常返回樣本

JSON格式

{
  "RequestId": "44B8C2F5-919D-5D29-BCD5-DEB03467****",
  "ErrCode": "DBS.ParamIsInValid",
  "Success": "true",
  "ErrMessage": "Argument: regionCode Must not be empty",
  "Code": "DBS.ParamIsInValid",
  "Message": "Argument: regionCode Must not be empty",
  "Data": {
    "PublicUrl": "http://dbs-137383785969****-cn-hangzhou-1iv12nblw****.oss-cn-hangzhou.aliyuncs.com/dt-u7u4bufa****/dbs_target_file_path/test_456",
    "PrivateUrl": "http://dbs-137383785969****-cn-hangzhou-1iv12nblw****.oss-cn-hangzhou-internal.aliyuncs.com/dt-u7u4bufa****/dbs_target_file_path/test_123",
    "ExpirationTime": 1661329050
  }
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

403 Request.Forbidden Have no Permissions 當前操作未被授權,請聯絡主帳號在RAM控制台進行授權後再執行操作

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情