日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

AI 助理
備案控制臺
文檔
輸入文檔關鍵字查找
首頁 云數據庫 MongoDB 版 開發參考 API參考指南 API目錄 備份與恢復 DescribeClusterBackups - 查詢集群備份集列表

DescribeClusterBackups - 查詢集群備份集列表

更新時間：
產品詳情
我的收藏

查詢云數據庫 MongoDB 版云盤版分片集群的集群備份集列表。

接口說明

2023 年 10 月 19 日前新建的云盤版分片集群實例，在調用前本接口前，需要調用 TransferClusterBackup 接口，完成分片備份到集群備份的轉換。

2023 年 10 月 19 日之后新建的云盤版分片集群實例，默認使用集群備份。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：

  • 操作：是指具體的權限點。
  • 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
  • 資源類型：是指操作中支持授權的資源類型。具體說明如下：
    • 對于必選的資源類型，用背景高亮的方式表示。
    • 對于不支持資源級授權的操作，用全部資源表示。
  • 條件關鍵字：是指云產品自身定義的條件關鍵字。
  • 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
dds:DescribeClusterBackupsget
  • Instance
    acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbInstanceId}
    無
無

請求參數

名稱類型必填描述示例值
DBInstanceIdstring是

實例 ID。

dds-bp16cb162771****
BackupIdstring否

集群備份 ID。

5664****
PageNointeger否

分頁頁號。默認值為 1，取值范圍為正整數。

1
PageSizeinteger否

每頁記錄數，取值：

  • 30（默認值）
  • 50
  • 100
30
StartTimestring否

查詢開始時間，格式為yyyy-MM-ddTHH:mmZ（UTC 時間）。

2019-03-13T12:11Z
EndTimestring否

查詢結束時間，必須晚于查詢開始時間，格式為yyyy-MM-ddTHH:mmZ（UTC 時間）。

2019-03-14T13:10Z
IsOnlyGetClusterBackUpboolean否

是否查詢集群備份下的子節點信息。取值說明：

  • true：只返回集群備份基本信息，不返回全量的子節點的備份信息。
  • false（默認 ）：返回全量的子節點的備份信息。
true
SrcRegionstring否

實例所在地域。

說明
  • 查詢已釋放實例的備份集列表式，該參數必填。
  • 查詢異地備份時，該參數必填。
    •
    		cn-hangzhou
    DestRegionstring否

    異地備份所在地域。

    說明 查詢異地備份時，該參數必填。
    		cn-shanghai

    返回參數

    名稱類型描述示例值
    object

    Schema of Response

    RequestIdstring

    請求 ID。

    		2F42BB4E-461F-5B55-A37C-53B1141C****
    MaxResultsinteger

    本次請求所返回的最大記錄條數。

    		10
    PageNumberinteger

    頁碼。

    		1
    PageSizeinteger

    每頁最大記錄數量。

    		30
    ClusterBackupsarray<object>

    集群備份集列表，一個集群備份里面包含各個節點的備份集。

    clusterBackupobject

    集群備份集列表，一個集群備份里面包含各個節點的備份集。

    IsAvailinteger

    集群備份集是否有效，取值說明：

    • 1：集群的備份集有效。
    • 0：子節點的備份集未完成或者失敗。
    		1
    ClusterBackupIdstring

    集群備份集 ID。

    		cb-o8c2ugnxo26kx***
    ClusterBackupStatusstring

    集群備份集狀態。

    		OK
    ClusterBackupStartTimestring

    集群備份開始時間。

    		2023-10-16T19:33:20Z
    ClusterBackupSizestring

    集群備份集大小，單位為 Byte。

    		107374182400
    ClusterBackupEndTimestring

    集群備份結束時間。

    		2023-10-16T19:33:20Z
    ClusterBackupModestring

    集群備份模式。

    		Automated
    ExtraInfoobject

    補充信息，為 JSON 格式。

    RegistryFromHistorystring

    是否來自于歷史備份集，為 1 則表示是從歷史備份集遷移過來的。

    		1
    Backupsarray<object>

    單個集群備份集下，各個子節點的備份集集合。

    backupobject

    單個集群備份集下，各個子節點的備份集集合。

    BackupIdstring

    備份 ID。

    		738025367
    InstanceNamestring

    MongoDB 分片名稱。

    		d-bp16cb162771****
    BackupDownloadURLstring

    備份文件的外網下載地址，若當前不可下載，則返回為空字符串。

    		http://oss.com/xxx
    BackupIntranetDownloadURLstring

    內網下載地址，若當前不可下載，則返回空值。

    		http://oss.com/xxx
    BackupStartTimestring

    本次備份開始時間，格式為yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    		2023-10-16T19:33:20Z
    BackupEndTimestring

    本次備份結束時間，格式為yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    		2023-10-16T19:33:20Z
    BackupSizestring

    備份文件大小，單位為 Byte。

    		77544597650
    IsAvailstring

    備份集是否可用，取值說明：

    • 0：不可用。
    • 1：可用。
    		1
    BackupStatusstring

    備份狀態，取值說明：

    • Success：備份成功。
    • Failed：備份失敗。
    		Success
    BackupNamestring

    備份名稱。

    		12345678.tar.gz
    ExtraInfoobject

    備份關聯的實例節點信息。

    NodeIdstring

    節點 ID。

    		d-2ze75ab1fa5d****
    StorageSizestring

    節點的存儲空間大小，單位為 MB。

    		20480
    InstanceClassstring

    節點規格。

    		mdb.shard.4x.large.d
    NodeTypestring

    節點類型。

    		db
    Progressstring

    備份進度，單位為%。 僅正在運行的備份才會顯示進度。

    		50
    AttachLogStatusstring

    備份的狀態，取值如下：

    • Init：初始化。
    • No_Need：無附加日志備份。
    • Running：附加日志備份中。
    • Ready：附加日志備份完成。
    • Failed：附加日志備份失敗。
    說明 當 ClusterBackupStatus 參數（集群備份集的狀態）的值為 OK 時，僅表示全量備份階段執行成功了，對于開啟了日志備份的集群實例，想要使用按時間點恢復或滿足一致性恢復的效果時，需要附加日志備份完成。
    		Ready
    EngineVersionstring

    備份時的實例版本號，取值：

    • 7.0
    • 6.0
    • 5.0
    • 4.4
    • 4.2
    • 4.0
    • 3.4
    		4.2

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "2F42BB4E-461F-5B55-A37C-53B1141C****",
  "MaxResults": 10,
  "PageNumber": 1,
  "PageSize": 30,
  "ClusterBackups": [
    {
      "IsAvail": 1,
      "ClusterBackupId": "cb-o8c2ugnxo26kx***",
      "ClusterBackupStatus": "OK",
      "ClusterBackupStartTime": "2023-10-16T19:33:20Z",
      "ClusterBackupSize": "107374182400",
      "ClusterBackupEndTime": "2023-10-16T19:33:20Z",
      "ClusterBackupMode": "Automated",
      "ExtraInfo": {
        "RegistryFromHistory": "1"
      },
      "Backups": [
        {
          "BackupId": "738025367",
          "InstanceName": "d-bp16cb162771****\n",
          "BackupDownloadURL": "http://oss.com/xxx",
          "BackupIntranetDownloadURL": "http://oss.com/xxx",
          "BackupStartTime": "2023-10-16T19:33:20Z",
          "BackupEndTime": "2023-10-16T19:33:20Z",
          "BackupSize": "77544597650",
          "IsAvail": "1",
          "BackupStatus": "Success",
          "BackupName": "12345678.tar.gz",
          "ExtraInfo": {
            "NodeId": "d-2ze75ab1fa5d****",
            "StorageSize": "20480",
            "InstanceClass": "mdb.shard.4x.large.d",
            "NodeType": "db"
          }
        }
      ],
      "Progress": "50",
      "AttachLogStatus": "Ready",
      "EngineVersion": "4.2"
    }
  ]
}

    錯誤碼

    HTTP status code錯誤碼錯誤信息
    400InvalidStartTime.MalformedThe Specified parameter StartTime is not valid.
    400InvalidEndTime.MalformedThe Specified parameter EndTime is not valid.
    400InvalidStartTimeAndEndTime.MalformedThe Specified parameter StartTime or EndTime is not valid.
    400InvalidPageSize.MalformedThe specified parameter PageSize is not valid.

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

    變更歷史

    變更時間變更內容概要操作
    2024-10-29OpenAPI 錯誤碼發生變更、OpenAPI 返回結構發生變更查看變更詳情
    2024-05-17OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更、OpenAPI 返回結構發生變更查看變更詳情