az dataprotection backup-policy retention-rule

注意

此參考是 Azure CLI 的數據保護延伸模組的一部分（2.57.0 版或更高版本）。 擴充功能會在您第一次執行 az dataprotection backup-policy retention-rule 命令時自動安裝。 深入了解擴充功能。

建立生命週期，並在備份原則中新增或移除保留規則。

命令

名稱	Description	類型	狀態
az dataprotection backup-policy retention-rule create-lifecycle	建立 Azure 保留規則的生命週期。	副檔名	GA
az dataprotection backup-policy retention-rule remove	拿掉備份原則中的現有保留規則。	副檔名	GA
az dataprotection backup-policy retention-rule set	新增保留規則或更新現有的保留規則。	副檔名	GA

az dataprotection backup-policy retention-rule create-lifecycle

建立 Azure 保留規則的生命週期。

az dataprotection backup-policy retention-rule create-lifecycle --count
                                                                --retention-duration-type {Days, Months, Weeks, Years}
                                                                --source-datastore {ArchiveStore, OperationalStore, VaultStore}
                                                                [--copy-option {CopyOnExpiryOption, CustomCopyOption, ImmediateCopyOption}]
                                                                [--target-datastore {ArchiveStore, OperationalStore, VaultStore}]

範例

建立每日生命週期

az dataprotection backup-policy retention-rule create-lifecycle --retention-duration-count 12 --retention-duration-type Days --source-datastore OperationalStore

必要參數

--count --retention-duration-count

保留期間計數。

--retention-duration-type --type

保留期間類型。

接受的值: Days, Months, Weeks, Years

--source-datastore

指定來源資料存放區。

接受的值: ArchiveStore, OperationalStore, VaultStore

選擇性參數

--copy-option

指定從來源資料存放區複製到目標資料存放區的複製選項。

接受的值: CopyOnExpiryOption, CustomCopyOption, ImmediateCopyOption

--target-datastore

指定目標數據存放區。

接受的值: ArchiveStore, OperationalStore, VaultStore

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az dataprotection backup-policy retention-rule remove

拿掉備份原則中的現有保留規則。

az dataprotection backup-policy retention-rule remove --name {Daily, Default, Monthly, Weekly, Yearly}
                                                      --policy

範例

拿掉保留規則

az dataprotection backup-policy retention-rule remove --name Daily --policy policy.json

必要參數

--name

指定要在原則中移除的保留規則名稱。

接受的值: Daily, Default, Monthly, Weekly, Yearly

--policy

現有的原則 Json 字串或檔案。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az dataprotection backup-policy retention-rule set

新增保留規則或更新現有的保留規則。

az dataprotection backup-policy retention-rule set --lifecycles
                                                   --name {Daily, Default, Monthly, Weekly, Yearly}
                                                   --policy

範例

新增每日保留規則

az dataprotection backup-policy retention-rule set --lifecycles dailylifecycle.json --name Daily --policy policy.json

必要參數

--lifecycles

要與保留規則相關聯的生命週期。 指定空格分隔的 json 檔名。

--name

指定要在原則中編輯的保留規則名稱。

接受的值: Daily, Default, Monthly, Weekly, Yearly

--policy

原則 Json 字串或檔案。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。