Compartilhar via

Criar políticas de backup da Proteção de Dados do Azure para blobs usando a API REST

  • Artigo

Este artigo descreve como criar políticas de backup da Proteção de Dados do Azure para Blobs do Azure usando a API REST.

Uma 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 uma agenda para executar os backups. A política é necessária essencialmente para especificar o período de retenção. Você pode reutilizar a política de backup para configurar o backup para várias contas de armazenamento a um cofre.

Importante

Antes de criar a política e configurar backups para blobs do Azure, confira 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.

Observação

A restauração por longa duração pode levar a uma conclusão mais lenta da operação de restauração. 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 1 milhão 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 uma restauração mais de 90 dias no passado não seriam recomendados para uma conta com essa taxa de alteração.

Neste artigo, os seguintes tópicos serão abordados:

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

Criar uma política

Para criar uma política do 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

O {policyName} e {vaultName} são fornecidas no URI. Você pode encontrar informações adicionais no corpo da solicitação.

Importante

Atualmente, não há suporte para a atualização ou modificação de uma política existente. Assim, é possível 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 o backup de blobs, use o seguinte componente do corpo da solicitação:

Nome Obrigatória Tipo Descrição
properties True BaseBackupPolicy:BackupPolicy Propriedades BaseBackupPolicyResource

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

Exemplo do corpo de solicitação

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

A diretiva diz:

  • O período de retenção é de 30 dias.
  • O armazenamento de dados é o “repositório 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 protegido, 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 com suporte são somente DateTime. Eles não têm suporte apenas do formato de Hora.

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 Descrição
200 OK BaseBackupPolicyResource OK

Respostas de exemplo

Depois que a operação for concluída, ele retorna 200 (OK) com o conteúdo de 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óximas etapas

Habilita 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: