az dataprotection enable-backup

備註

此參考文獻是Azure CLIdataprotection擴充套件（版本 2.75.0 或更高版本）的一部分。 這個擴充功能會在你第一次執行 az dataprotection enable-backup 指令時自動安裝。 深入了解擴充功能。

啟用 Azure 資源備份。

命令

名稱 Description 類型 狀態
az dataprotection enable-backup trigger

透過設定所有必要資源（包括備份保險庫、政策、儲存帳號、擴充功能及受信任存取）來啟用 AKS 叢集的備份。

 擴充功能 GA

az dataprotection enable-backup trigger

透過設定所有必要資源（包括備份保險庫、政策、儲存帳號、擴充功能及受信任存取）來啟用 AKS 叢集的備份。

此指令協調啟用 AKS 叢集備份所需的所有步驟：

  1. 建立或重用備用資源群組、儲存帳號及 blob 容器
  2. 在叢集上安裝備份擴充功能（或重複使用現有擴充功能）
  3. 建立或重用備份保險庫與備份政策
  4. 設定可信存取與角色指派
  5. 建立一個備用實例

--backup-configuration-file 參數接受 JSON 檔案（@file.json）或內嵌 JSON 字串，並可選擇以下設定：

  • storageAccountResourceId：用於現有儲存帳號的 ARM ID
  • blobContainerName：現有 blob 容器名稱（與 storageAccountResourceID 搭配使用）
  • backupResourceGroupId：現有備份資源群組的 ARM ID
  • backupVaultId：現有備份保險庫的 ARM ID（自訂策略所需）
  • backupPolicyId：現有備份政策的 ARM ID（自訂策略所需）
  • 標籤：用於建立資源的標籤字典（例如 {“Owner”： “team”， “Env”： “prod”}）

備份策略預設（--backup-strategy）：

  • 週（預設）：每日增量備份，營運儲存中保留7天。
  • 月份：每日增量備份，營運儲存庫保留 30 天。
  • 災難復原：每日增量備份，使用 7 天的營運儲存 + 90 天的保管庫儲存。 FirstOfDay 備份會被複製到 Vault Store，以便跨區域還原。
  • 客製化：自備保險庫和保單。 需要在 --backup-configuration-file 中 backupVaultId 和 backupPolicyId。
az dataprotection enable-backup trigger --datasource-id
                                        --datasource-type
                                        [--acquire-policy-token]
                                        [--backup-configuration-file]
                                        [--backup-strategy {Custom, DisasterRecovery, Month, Week}]
                                        [--change-reference]
                                        [--yes]

範例

啟用 AKS 叢集的備份，使用預設的 Week 策略

az dataprotection enable-backup trigger --datasource-type AzureKubernetesService --datasource-id /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.ContainerService/managedClusters/{cluster}

啟用 Payment Payment 策略的備份

az dataprotection enable-backup trigger --datasource-type AzureKubernetesService --datasource-id /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.ContainerService/managedClusters/{cluster} --backup-strategy Month

利用現有的保險庫與政策啟用自訂策略的備份

az dataprotection enable-backup trigger --datasource-type AzureKubernetesService \
  --datasource-id /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.ContainerService/managedClusters/{cluster} \
  --backup-strategy Custom \
  --backup-configuration-file @config.json

Where config.json contains:
{
  "backupVaultId": "/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.DataProtection/backupVaults/{vault}",
  "backupPolicyId": "/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.DataProtection/backupVaults/{vault}/backupPolicies/{policy}"
}

啟用帶有資源標籤的備份以符合政策

az dataprotection enable-backup trigger --datasource-type AzureKubernetesService \
  --datasource-id /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.ContainerService/managedClusters/{cluster} \
  --backup-configuration-file '{"tags": {"Owner": "team", "Environment": "prod", "DeleteBy": "2026-12"}}'

啟用現有儲存帳號的備份

az dataprotection enable-backup trigger --datasource-type AzureKubernetesService \
  --datasource-id /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.ContainerService/managedClusters/{cluster} \
  --backup-configuration-file @config.json

Where config.json contains:
{
  "storageAccountResourceId": "/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.Storage/storageAccounts/{sa}",
  "blobContainerName": "my-backup-container"
}

必要參數

--datasource-id

要備份資料來源的完整 ARM 資源 ID。

--datasource-type

需要備份的資料來源類型。 Supported values： AzureKubernetesService.

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--backup-configuration-file -f

指向 JSON 備份設定檔的路徑。 支援 backupVaultId 與 backupPolicyId（自訂策略所需）。 關於特定工作負載的設定，請參閱文件。

--backup-strategy

備份策略預設（每日增量備份）。 針對 AzureKubernetesService：週（7 天營運儲存儲存）、Month（30 天營運儲存儲存）、災難復原（7 天營運 + 90 天保險庫儲存保留）、自訂（自備保險庫/政策）。 預設：一週。

屬性 值
接受的值: Custom, DisasterRecovery, Month, Week
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--yes -y

不提示確認。

屬性 值
預設值: False
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False