次の方法で共有

REST API を使用して BLOB 用の Azure データ保護バックアップ ポリシーを作成する

この記事では、REST API を使用して Azure BLOB 用の Azure データ保護バックアップ ポリシーを作成する方法について説明します。

通常、Azure Backup ポリシーを使用してバックアップの保持期間とスケジュールを制御します。 BLOB の運用バックアップは継続的に行われるため、バックアップを実行するスケジュールは必要ありません。 ポリシーは、基本的に保持期間を指定するために必要です。 バックアップ ポリシーを再利用して、複数のストレージ アカウントのコンテナーへのバックアップを構成できます。

重要

ポリシーの作成と Azure BLOB のバックアップの構成に進む前に、このセクションを参照してください。

この記事では、ストレージ アカウントで BLOB のポリシーを作成する方法について説明します。 REST API を使用して Azure Recovery Services コンテナーのバックアップ ポリシーを作成するプロセスについて説明します。

Note

長期間を対象にした復元の場合、復元操作の完了に時間がかかることがあります。 また、一連のデータの復元にかかる時間は、復元期間中に行われた書き込み操作と削除操作の数に基づきます。 たとえば、100 万オブジェクトを持つアカウントで毎日 3,000 オブジェクトが追加され、毎日 1,000 オブジェクトが削除される場合、過去 30 日間のポイントまで復元するのに約 2 時間必要になります。 1 保有期間と過去 90 日間の復元は、この変更率のアカウントには推奨されません。

この記事では、次の内容について説明します。

  • ポリシーの作成
  • 要求本文を作成する
  • 応答

ポリシーの作成

Azure Backup ポリシーを作成するには、次の PUT 操作を使用します。

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies/{policyName}?api-version=2021-01-01

{policyName} と {vaultName} は URI で指定します。 要求本文に関する追加情報を確認できます。

重要

現在、既存のポリシーの更新または変更はサポートされていません。 そのため、必要な詳細情報を使用して新しいポリシーを作成し、関連するバックアップ インスタンスに割り当てることができます。

要求本文を作成する

たとえば、BLOB のバックアップに対するポリシーを作成する場合、要求本文の次のコンポーネントを使用します。

名前 Required タイプ 説明
properties True BaseBackupPolicy:BackupPolicy BaseBackupPolicyResource のプロパティ

要求本文での定義の完全なリストについては、バックアップ ポリシー REST API に関するドキュメントを参照してください。

要求本文の例

次の要求本文では、BLOB のバックアップに対するバックアップ ポリシーが定義されています。

次のようなポリシーです。

  • 保持期間は 30 日です。
  • データストアは "運用ストア" です。
{
  "properties": {
    "datasourceTypes": [
      "Microsoft.Storage/storageAccounts/blobServices"
    ],
    "objectType": "BackupPolicy",
    "policyRules": [
      {
        "name": "Default",
        "objectType": "AzureRetentionRule",
        "isDefault": true,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P30D",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "OperationalStore",
              "objectType": "DataStoreInfoBase"
            }
          }
        ]
      }
    ]
  }
}

コンテナー化されたバックアップ を使ってバックアップ ポリシーを構成するには、次の JSON スクリプトを使います。

{
  "id": "/subscriptions/495944b2-66b7-4173-8824-77043bb269be/resourceGroups/Blob-Backup/providers/Microsoft.DataProtection/BackupVaults/yavovaultecy01/backupPolicies/TestPolicy",
  "name": "TestPolicy",
  "type": "Microsoft.DataProtection/BackupVaults/backupPolicies",
  "properties": {
    "policyRules": [
      {
        "name": "Default",
        "objectType": "AzureRetentionRule",
        "isDefault": true,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P30D",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "OperationalStore",
              "objectType": "DataStoreInfoBase"
            },
            "targetDataStoreCopySettings": []
          }
        ]
      },
      {
        "name": "Default",
        "objectType": "AzureRetentionRule",
        "isDefault": true,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P7D",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            },
            "targetDataStoreCopySettings": []
          }
        ]
      },
      {
        "name": "BackupDaily",
        "objectType": "AzureBackupRule",
        "backupParameters": {
          "backupType": "Discrete",
          "objectType": "AzureBackupParams"
        },
        "dataStore": {
          "dataStoreType": "VaultStore",
          "objectType": "DataStoreInfoBase"
        },
        "trigger": {
          "schedule": {
            "timeZone": "UTC",
            "repeatingTimeIntervals": [
              "R/2024-05-08T14:00:00+00:00/P1D"
            ]
          },
          "taggingCriteria": [
            {
              "isDefault": true,
              "taggingPriority": 99,
              "tagInfo": {
                "id": "Default_",
                "tagName": "Default"
              }
            }
          ],
          "objectType": "ScheduleBasedTriggerContext"
        }
      }
    ],
    "datasourceTypes": [
      "Microsoft.Storage/storageAccounts/blobServices"
    ],
    "objectType": "BackupPolicy",
    "name": "TestPolicy"
  }
}

重要

サポートされている時刻形式は DateTime のみです。 Time 形式のみはサポートされません。

応答

バックアップ ポリシーの作成と更新は同期操作であり、操作が正常に終了すると OK が返されます。

名前 種類 説明
200 OK BaseBackupPolicyResource OK

応答の例

操作が完了すると、応答本文にポリシーの内容が含まれる 200 (OK) が返されます。

{
  "id": "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups//TestBkpVaultRG/providers/Microsoft.RecoveryServices/vaults/testBkpVault/backupPolicies/TestBlobPolicy",
  "name": "TestBlobPolicy",
  "type": "Microsoft.DataProtection/backupVaults/backupPolicies",
  "properties": {
    "policyRules": [
      {
        "lifecycles": [
          {
            "deleteAfter": {
              "objectType": "AbsoluteDeleteOption",
              "duration": "P30D"
            },
            "sourceDataStore": {
              "dataStoreType": "OperationalStore",
              "objectType": "DataStoreInfoBase"
            }
          }
        ],
        "isDefault": true,
        "name": "Default",
        "objectType": "AzureRetentionRule"
      }
    ],
    "datasourceTypes": [
      "Microsoft.Storage/storageAccounts/blobServices"
    ],
    "objectType": "BackupPolicy"
  }
}

次のステップ

ストレージ アカウントで BLOB の保護を有効にします。

Azure Backup REST API について詳しくは、次のドキュメントをご覧ください。