全部產品
Search
文件中心

Cloud Backup:DescribePoliciesV2 - 查詢一個或多個策略

更新時間:Sep 18, 2025

查詢一個或多個策略。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

hbr:DescribePoliciesV2

list

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

NextToken

string

擷取下一頁策略所需的 Token。

caeba0bbb2be03f84eb48b699f0a

MaxResults

integer

每次查詢結果的個數。

取值範圍:10~100。預設值:10。

10

PolicyId

string

策略 ID。

po-000************2l6

返回參數

名稱

類型

描述

樣本值

object

DescribePoliciesResponse

Policies

array<object>

策略列表。

object

策略詳情。

CreatedTime

integer

建立時間。UNIX 時間,單位秒。

1650248136

UpdatedTime

integer

更新時間。UNIX 時間,單位為秒。

1662080404

PolicyId

string

策略 ID。

po-000************bkz

PolicyName

string

策略名稱稱。

每天備份 + 異地備份

PolicyDescription

string

策略描述。

每天早上十點備份,異地複寫到上海。

Rules

array<object>

策略規則列表。

object

策略規則詳情。

RuleId

string

規則 ID。

rule-000************f1e

RuleType

string

規則類型,每一個策略需要至少有一個 BACKUP 類型規則,有且僅有一個 TRANSITION 類型規則:

  • BACKUP:備份規則。

  • TRANSITION:生命週期規則。

  • REPLICATION:複製規則。

BACKUP

Schedule

string

僅當 RuleType 取值為 BACKUP 時,需要配置該參數。備份定時設定。可選格式:I|{startTime}|{interval}。表示從{startTime}開始每隔{interval}的時間執行一次備份任務。不會補償已過去時間的備份任務。如果上一次備份任務沒有完成,不會觸發下一次備份任務。例如I|1631685600|P1D表示從 2021-09-15 14:00:00 開始每隔一天備份一次。

  • startTime:備份起始時間,UNIX 時間,單位為秒。

  • interval: ISO8601 時間間隔。例如:PT1H 表示間隔一小時。P1D 表示間隔一天。

I|1648647166|P1D

BackupType

string

僅當 RuleType 取值為 BACKUP 時,需要配置該參數。備份類型。取值為 COMPLETE,表示全量備份。

COMPLETE

VaultId

string

僅當 RuleType 取值為 BACKUP 時,需要配置該參數。備份庫 ID。

v-000**************kgm

ReplicationRegionId

string

僅當 RuleType 取值為 REPLICATION 時,需要配置該參數。複製的目標地區 ID。

cn-shanghai

Retention

integer

僅當 RuleType 取值為 TRANSITIONREPLICATION 時,需要配置該參數。

  • RuleType 取值為 TRANSITION:備份保留時間,最小值為 1,單位為天。

  • RuleType 取值為 REPLICATION:異地備份保留時間,最小值為 1,單位為天。

7

RetentionRules

array<object>

僅當 RuleType 取值為 TRANSITION 時,需要配置該參數。特殊保留規則列表。

object

特殊保留規則。

AdvancedRetentionType

string

特殊保留規則類型:

  • WEEKLY:每周的備份

  • MONTHLY:每月的備份

  • YEARLY:每年的備份

YEARLY

WhichSnapshot

integer

針對第幾個備份生效,當前僅支援第 1 個備份,值為 1。

1

Retention

integer

備份的特殊保留時間,最小值為 1,單位為天。

730

ArchiveDays

integer

僅當 RuleType 取值為 TRANSITION 時,需要配置該參數。備份轉為歸檔的時間,單位為天。

30

KeepLatestSnapshots

integer

是否開啟保留至少一個備份版本。

  • 0:不保留。

  • 1:保留。

1

DataSourceFilters

array<object>

僅當 RuleType 取值為 TAG 時,需要配置該參數。資料來源過濾規則。

object

SourceType

string

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

  • UDM_ECS:表示 ECS 整機備份。

  • OSS:表示 OSS 備份。

  • NAS:表示阿里雲 NAS 備份。

  • ECS_FILE:表示 ECS 檔案備份。

  • OTS:表示 Tablestore 備份。

UDM_ECS

DataSourceIds

array

已廢棄。

string

已廢棄。

已廢棄。

TagFilters

array<object>

僅當 RuleType 取值為 TAG 時,需要配置該參數。資源標籤過濾規則。

object

Key

string

標籤鍵。

env

Value

string

標籤值,為空白時表示任意值。

prod

Operator

string

標籤匹配規則,支援

  • EQUAL:匹配標籤鍵和標籤值。

  • NOT:匹配標籤鍵,不匹配標籤值。

EQUAL

Immutable

boolean

僅當 PolicyTypeUDM_ECS_ONLY時,該欄位有效。表示是否開啟備份鎖定。

true

PolicyBindingCount

integer

策略已繫結資料源數量。

5

PolicyType

string

策略類型,支援:

  • STANDARD:通用備份策略,支援備份除 ECS 整機備份以外的資料來源。

  • UDM_ECS_ONLY:整機備份策略,僅支援備份 ECS 整機。

STANDARD

BusinessStatus

string

使用者業務狀態

ACTIVE

NextToken

string

擷取下一頁策略所需的 Token。

caeba0bbb2be03f84eb48b699f0a

MaxResults

integer

每次查詢結果的個數。

取值範圍:10~100。預設值:10。

10

TotalCount

integer

總記錄數。

12

Success

boolean

請求是否成功。

  • true:成功

  • false:失敗

true

Code

string

返回碼。200 表示成功。

200

Message

string

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

successful

RequestId

string

請求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

樣本

正常返回樣本

JSON格式

{
  "Policies": [
    {
      "CreatedTime": 1650248136,
      "UpdatedTime": 1662080404,
      "PolicyId": "po-000************bkz",
      "PolicyName": "每天備份 + 異地備份",
      "PolicyDescription": "每天早上十點備份,異地複寫到上海。",
      "Rules": [
        {
          "RuleId": "rule-000************f1e",
          "RuleType": "BACKUP",
          "Schedule": "I|1648647166|P1D",
          "BackupType": "COMPLETE",
          "VaultId": "v-000**************kgm",
          "ReplicationRegionId": "cn-shanghai",
          "Retention": 7,
          "RetentionRules": [
            {
              "AdvancedRetentionType": "YEARLY",
              "WhichSnapshot": 1,
              "Retention": 730
            }
          ],
          "ArchiveDays": 30,
          "KeepLatestSnapshots": 1,
          "DataSourceFilters": [
            {
              "SourceType": "UDM_ECS",
              "DataSourceIds": [
                "已廢棄。"
              ]
            }
          ],
          "TagFilters": [
            {
              "Key": "env",
              "Value": "prod",
              "Operator": "EQUAL"
            }
          ],
          "Immutable": true
        }
      ],
      "PolicyBindingCount": 5,
      "PolicyType": "STANDARD",
      "BusinessStatus": "ACTIVE"
    }
  ],
  "NextToken": "caeba0bbb2be03f84eb48b699f0a",
  "MaxResults": 10,
  "TotalCount": 12,
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情