Partilhar via

Criar políticas de backup do Azure Data Protection para blobs usando a API REST

  • Artigo

Este artigo descreve como criar políticas de backup do Azure Data Protection para Blobs do Azure usando a API REST.

A política de Backup do Azure normalmente rege a retenção e o agendamento de seus backups. Como o backup operacional para blobs é contínuo por natureza, você não precisa de um agendamento para executar backups. A política é essencialmente necessária para especificar o período de retenção. Você pode reutilizar a política de backup para configurar o backup de várias contas de armazenamento em um cofre.

Importante

Antes de continuar a criar a política e configurar backups para blobs do Azure, consulte esta seção.

Este artigo descreve como criar uma política para blobs em uma conta de armazenamento. Saiba mais sobre o processo para criar uma política de backup para um cofre dos Serviços de Recuperação do Azure usando a API REST.

Nota

A restauração por longos períodos pode levar a que as operações de restauração demorem mais tempo para serem concluídas. Além disso, o tempo necessário para restaurar um conjunto de dados é baseado no número de operações de gravação e exclusão feitas durante o período de restauração. Por exemplo, uma conta com um milhão de objetos com 3.000 objetos adicionados por dia e 1.000 objetos excluídos por dia exigirá aproximadamente duas horas para restaurar para um ponto de 30 dias no passado. Um período de retenção e restauração superior a 90 dias no passado não seria recomendado para uma conta com esta taxa de alteração.

Neste artigo, ficará a saber mais sobre:

  • Criar uma política
  • Criar o corpo da solicitação
  • Respostas

Criar uma política

Para criar uma política de Backup do Azure, use a seguinte operação PUT :

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

Os {policyName} e {vaultName} são fornecidos no URI. Você pode encontrar informações adicionais no corpo do pedido.

Importante

Atualmente, não suportamos a atualização ou modificação de uma política existente. Assim, você pode criar uma nova política com os detalhes necessários e atribuí-la à instância de backup relevante.

Criar o corpo da solicitação

Por exemplo, para criar uma política para backup de Blob, use o seguinte componente do corpo da solicitação:

Nome Obrigatório Type Description
properties True BaseBackupPolicy:BackupPolicy BaseBackupPolicyResource propriedades

Para obter a lista completa de definições no corpo da solicitação, consulte o documento da API REST da política de backup.

Exemplo de corpo da solicitação

O corpo da solicitação a seguir define uma política de backup para backups de blob.

A política diz:

  • O período de retenção é de 30 dias.
  • Datastore é 'armazenamento operacional'.
{
  "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"
            }
          }
        ]
      }
    ]
  }
}

Para configurar uma política de backup com o backup em cofre, use o seguinte script 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"
  }
}

Importante

Os formatos de hora suportados são apenas DateTime . Eles não suportam apenas o formato Time .

Respostas

A criação/atualização da política de backup é uma operação assíncrona e retorna OK quando a operação é bem-sucedida.

Nome Tipo Description
200 OK BaseBackupPolicyResource OK

Exemplos de respostas

Quando a operação for concluída, ela retornará 200 (OK) com o conteúdo da política no corpo da resposta.

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

Próximos passos

Habilite a proteção para blobs em uma conta de armazenamento.

Para obter mais informações sobre as APIs REST do Backup do Azure, consulte os seguintes documentos: