az dataprotection enable-backup

注

このリファレンスは、Azure CLI (バージョン 2.75.0 以降) の dataprotection 拡張機能の一部です。 拡張機能は、 az dataprotection enable-backup コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。

Azure リソースのバックアップを有効にします。

コマンド

名前 説明 型 状態
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 (カスタム戦略に必要)
  • tags: 作成されたリソースに適用するタグの辞書 (例: {"Owner": "team", "Env": "prod"})

バックアップ戦略プリセット (--backup-strategy):

  • 週 (既定値): オペレーション ストアでの 7 日間のリテンション期間を含む毎日の増分バックアップ。
  • 月: オペレーション ストアでの 30 日間のリテンション期間を含む毎日の増分バックアップ。
  • DisasterRecovery: 7 日間の Operational Store + 90 日間のコンテナー ストアリテンション期間を使用した毎日の増分バックアップ。 FirstOfDay バックアップは、リージョンをまたがる復元のために Vault ストアにコピーされます。
  • カスタム: 独自のコンテナーとポリシーを持ち込みます。 --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 クラスターのバックアップを有効にする

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

月の戦略でバックアップを有効にする

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

バックアップするデータソースの種類。 サポートされている値: AzureKubernetesService。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--backup-configuration-file -f

JSON バックアップ構成ファイルへのパス。 backupVaultId と backupPolicyId (カスタム戦略に必要) をサポートします。 ワークロード固有の設定については、ドキュメントを参照してください。

--backup-strategy

バックアップ戦略プリセット (毎日の増分バックアップ)。 AzureKubernetesService の場合: 週 (7 日間の運用ストアリテンション期間)、月 (30 日間の運用ストアリテンション期間)、DisasterRecovery (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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False