Freigeben über

Erstellen von Azure Data Protection-Sicherungsrichtlinien für Blobs mithilfe der REST-API

  • Artikel

In diesem Artikel wird beschrieben, wie Sie Sicherungsrichtlinien für den Schutz von Daten in Azure für Azure-Blobs mithilfe der REST-API erstellen.

Eine Azure Backup-Richtlinie regelt in der Regel die Aufbewahrung und den Zeitplan für Ihre Sicherungen. Da die operative Sicherung für Blobs fortlaufend erfolgt, benötigen Sie keinen Zeitplan für die Durchführung von Sicherungen. Die Richtlinie ist im Grunde genommen erforderlich, um den Aufbewahrungszeitraum festzulegen. Sie können die Sicherungsrichtlinie wiederverwenden, um die Sicherung für mehrere Speicherkonten in einem Tresor zu konfigurieren.

Wichtig

Bevor Sie mit dem Erstellen der Richtlinie und dem Konfigurieren von Sicherungen für Azure-Blobs fortfahren, lesen Sie diesen Abschnitt.

In diesem Artikel wird beschrieben, wie Sie eine Richtlinie für Blobs in einem Speicherkonto erstellen. Erfahren Sie mehr über den Prozess zum Erstellen einer Sicherungsrichtlinie für einen Azure Recovery Services-Tresor mithilfe der REST-API.

Hinweis

Eine Wiederherstellung über einen längeren Zeitraum kann dazu führen, dass die Wiederherstellungsvorgänge länger dauern. Außerdem hängt die erforderliche Zeit zum Wiederherstellen einer Gruppe von Daten von der Anzahl Schreib- und Löschvorgänge ab, die während des Wiederherstellungszeitraums vorgenommen werden. Beispielsweise dauert bei einem Konto mit 1 Million Objekten, in dem pro Tag 3.000 Objekte hinzugefügt und 1.000 Objekte gelöscht werden, die Wiederherstellung zu einem 30 Tage in der Vergangenheit liegenden Zeitpunkt ungefähr zwei Stunden. Bei einem Konto mit einer solchen Änderungsrate wird davon abgeraten, einen Aufbewahrungszeitraum mit einer Wiederherstellung, die mehr als 90 Tage in der Vergangenheit liegt, anzuwenden.

In diesem Artikel erfahren Sie mehr über die folgenden Themen:

  • Erstellen einer Richtlinie
  • Erstellen des Anforderungstexts
  • Antworten

Erstellen einer Richtlinie

Verwenden Sie den folgenden PUT-Vorgang, um eine Azure Backup-Richtlinie zu erstellen:

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

Der {policyName} und der {vaultName} werden im URI angegeben. Weitere Informationen finden Sie im Anforderungstext.

Wichtig

Derzeit wird das Aktualisieren oder Ändern einer vorhandenen Richtlinie nicht unterstützt. Alternativ dazu können Sie eine neue Richtlinie mit den erforderlichen Details erstellen und sie der relevanten Sicherungsinstanz zuweisen.

Erstellen des Anforderungstexts

Um z. B. eine Richtlinie für Blobsicherungen zu erstellen, verwenden Sie die folgende Komponente des Anforderungstexts:

Name Erforderlich Typ Beschreibung
properties True BaseBackupPolicy:BackupPolicy BaseBackupPolicyResource-Eigenschaften

Eine vollständige Liste der Definitionen im Anforderungstext finden Sie im REST-API-Dokument zur Sicherungsrichtlinie.

Beispiel für Anforderungstext

Im folgenden Anforderungstext wird eine Sicherungsrichtlinie für Blobsicherungen definiert.

Die Richtlinie besagt Folgendes:

  • Die Beibehaltungsdauer beträgt 30 Tage.
  • Der Datenspeicher ist ein „Betriebsspeicher“.
{
  "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"
            }
          }
        ]
      }
    ]
  }
}

Um eine Sicherungsrichtlinie mit der Tresorsicherung zu konfigurieren, verwenden Sie das folgende JSON-Skript:

{
  "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"
  }
}

Wichtig

Die unterstützten Zeitformate sind nur DateTime. Das Time-Format allein wird nicht unterstützt.

Antworten

Die Erstellung/Aktualisierung der Sicherungsrichtlinie ist ein asynchroner Vorgang und gibt OK zurück, sobald der Vorgang erfolgreich war.

Name Typ BESCHREIBUNG
200 OK BaseBackupPolicyResource OK

Beispielantworten

Wenn der Vorgang abgeschlossen ist, wird 200 (OK) mit dem Richtlinieninhalt im Antworttext zurückgegeben.

{
  "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"
  }
}

Nächste Schritte

Aktivieren Sie den Schutz für Blobs in einem Speicherkonto.

Weitere Informationen zu den Azure Backup-REST-APIs finden Sie in den folgenden Dokumenten: