全部產品
Search

搜尋本產品

    Cloud Backup：DescribeOtsTableSnapshots - 查詢Table Store備份詳情

    文件中心

    Cloud Backup：DescribeOtsTableSnapshots - 查詢Table Store備份詳情

    更新時間：Dec 23, 2025

    查詢Table Store備份詳情。

    調試

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

    調試

    授權資訊

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

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

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    hbr:DescribeOtsTableSnapshots

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    StartTime

    integer

    否

    備份開始時間。UNIX 時間，單位為毫秒。

    1611109271630
    EndTime

    integer

    否

    備份結束時間。UNIX 時間，單位為毫秒。

    1652068250881
    SnapshotIds

    array

    否

    快照列表。

    string

    否

    快照 ID 列表。

    s-00047mxg17p26****3c
    OtsInstances

    array<object>

    否

    備份的Table Store執行個體列表。

    object

    否

    備份的Table Store執行個體列表。

    InstanceName

    string

    否

    備份的Table Store執行個體名稱。

    instancename
    TableNames

    array

    否

    備份的Table Store資料表名稱。

    string

    否

    備份的Table Store資料表名稱。

    tablename
    Limit

    integer

    否

    本次查詢需要返回的最大數量。

    100
    NextToken

    string

    否

    擷取下一頁快照所需的 Token。

    caeba0bbb2be03f84eb48b699f0a****
    CrossAccountType

    string

    否

    跨帳號備份類型。支援：

    • SELF_ACCOUNT：本帳號備份

    • CROSS_ACCOUNT：跨帳號備份

    CROSS_ACCOUNT
    CrossAccountUserId

    integer

    否

    用於跨帳號備份的原帳號 Uid。

    144015xxxxx98732
    CrossAccountRoleName

    string

    否

    用於跨帳號備份的原帳號 RAM 中建立的角色名稱。

    BackupRole

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    09376812-6290-5E36-B504-E8010D72D1F0
    Success

    boolean

    請求是否成功。

    • true：成功。

    • false：失敗。

    true
    Code

    string

    返回碼，200 表示成功。

    200
    Message

    string

    返回資訊描述，成功一般返回 successful，錯誤時會返回相應錯誤資訊。

    successful
    Limit

    integer

    當前頁顯示快照數量。

    10
    Snapshots

    array<object>

    快照列表。

    object

    Status

    string

    備份快照任務的狀態。取值範圍：

    • COMPLETE：成功

    • PARTIAL_COMPLETE：部分成功

    • FAILED：失敗

    COMPLETE
    SnapshotHash

    string

    快照 HASH 值。

    f2fe...
    VaultId

    string

    儲存備份庫快照的倉庫 ID。

    v-00030j*******sn
    BackupType

    string

    備份類型。取值為 COMPLETE，表示全量備份。

    COMPLETE
    CreateTime

    integer

    表示Table Store建立時間。UNIX 時間，單位為秒。

    1607436917
    ActualBytes

    string

    去重後快照實際資料量。單位為位元組。

    0
    SourceType

    string

    資料來源類型。取值範圍：

    • ECS_FILE：ECS 檔案的備份快照。

    • OSS：阿里雲 OSS 的備份快照。

    • NAS：阿里雲 NAS 的備份快照。

    • OTS_TABLE：阿里雲Table Store的備份快照。

    OTS_TABLE
    BytesTotal

    integer

    資料來源總量。單位為位元組。

    0
    CompleteTime

    integer

    備份快照完成時間。UNIX 時間，單位為秒。

    1642496679
    Retention

    integer

    備份快照保留天數。

    730
    CreatedTime

    integer

    備份快照的建立時間。UNIX 時間，單位為秒。

    1642496679
    ParentSnapshotHash

    string

    父備份的快照 HASH 值。

    f2fe..
    StartTime

    integer

    快照開始時間。UNIX 時間，單位為秒。

    1642496543
    UpdatedTime

    integer

    備份快照的更新時間。UNIX 時間，單位為秒。

    1642496679
    SnapshotId

    string

    備份快照 ID。

    s-00047mxg17p26*****b
    JobId

    string

    備份任務 ID。

    job-00030j3chkt******2
    InstanceName

    string

    Table Store執行個體名稱。

    instancename
    TableName

    string

    Table Store執行個體的資料表名稱。

    table2
    RangeStart

    integer

    備份任務開始執行時間。UNIX 時間，單位為毫秒。

    1642492553038
    RangeEnd

    integer

    備份任務結束執行時間。UNIX 時間，單位為毫秒。

    1642521709966
    NextToken

    string

    擷取下一頁快照所需的 Token。

    caeba0bbb2be03f84eb48b699f0a

    樣本

    正常返回樣本

    JSON格式

    {
  "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"
}

    錯誤碼

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

    變更歷史

    更多資訊，參考變更詳情。