Condividi tramite

Creare criteri di backup di Protezione dati di Azure per i BLOB usando l'API REST

Questo articolo descrive come creare criteri di backup di Protezione dati di Azure per i BLOB di Azure usando l'API REST.

I criteri di Backup di Azure regolano in genere la conservazione e la pianificazione dei backup. Poiché il backup operativo per i BLOB è di natura continua, non è necessaria una pianificazione per eseguire i backup. I criteri sono sostanzialmente necessari per specificare il periodo di conservazione. È possibile riutilizzare i criteri di backup per configurare il backup per più account di archiviazione in un insieme di credenziali.

Importante

Prima di procedere con la creazione dei criteri e la configurazione dei backup per i BLOB di Azure, vedere questa sezione.

Questo articolo descrive come creare criteri per i BLOB in un account di archiviazione. Informazioni sul processo di creazione di criteri di backup per un insieme di credenziali di Servizi di ripristino di Azure tramite l'API REST.

Nota

Periodi di ripristino lunghi possono comportare l'incremento del tempo necessario al completamento delle operazioni di ripristino. Inoltre, il tempo necessario per ripristinare un set di dati si basa sul numero di operazioni di scrittura ed eliminazione eseguite durante il periodo di ripristino. Ad esempio, un account con un milione di oggetti e con 3.000 oggetti aggiunti e 1.000 oggetti eliminati al giorno richiederà circa due ore per il ripristino a un punto corrispondente a 30 giorni nel passato. Un periodo di conservazione e un ripristino superiore a 90 giorni nel passato è sconsigliabile per un account con questa frequenza di modifica.

Questo articolo contiene informazioni relative agli argomenti seguenti:

  • Creare un criterio
  • Creare il corpo della richiesta
  • Risposte

Creare un criterio

Per creare un criterio di Backup di Azure usare l'operazione PUT seguente:

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

I parametri {policyName} e {vaultName} vengono forniti nell'URI. Nel corpo della richiesta sono disponibili informazioni aggiuntive.

Importante

L'aggiornamento o la modifica di un criterio esistente non sono al momento supportati. È quindi possibile creare un nuovo criterio con i dettagli necessari e assegnarlo all'istanza di backup pertinente.

Creare il corpo della richiesta

Ad esempio, per creare un criterio per il backup dei BLOB, usare il componente seguente del corpo della richiesta:

Nome Obbligatorio Type Descrizione
properties Vero BaseBackupPolicy:BackupPolicy Proprietà di BaseBackupPolicyResource

Per l'elenco completo delle definizioni nel corpo della richiesta, vedere il documento relativo all'API REST dei criteri di backup.

Esempio di corpo della richiesta

Il corpo della richiesta seguente definisce un criterio di backup per i backup dei BLOB.

Il criterio indica:

  • Il periodo di conservazione è di 30 giorni.
  • L'archivio dati è un "archivio operativo".
{
  "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"
            }
          }
        ]
      }
    ]
  }
}

Per configurare un criterio di backup con il backup che si trova nell'insieme di credenziali, usare lo script JSON seguente:

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

Importante

Il formato dell'ora supportato è solo DateTime. Il formato Time da solo non è supportato.

Risposte

La creazione e l'aggiornamento dei criteri di backup sono operazioni asincrone che restituiscono OK quando vengono completate correttamente.

Nome Tipo Descrizione
200 OK BaseBackupPolicyResource OK

Risposte di esempio

Al termine dell'operazione, viene restituita la risposta 200 (OK) con il contenuto dei criteri nel corpo della risposta.

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

Passaggi successivi

Abilitare la protezione per i BLOB in un account di archiviazione.

Per altre informazioni sulle API REST di Backup di Azure, vedere i documenti seguenti:

  • Last updated on