Criar políticas de backup de proteção de dados Azure para discos que utilizem API REST

Uma política de backup governa a retenção e o horário dos seus backups. O Azure Disk Backup oferece várias cópias de segurança por dia.

Pode reutilizar a política de backup para configurar a cópia de segurança de vários Discos Azure para um cofre ou criar uma política de backup para um cofre dos Serviços de Recuperação do Azure utilizando a API REST.

Para criar uma política de backup de discos, execute as seguintes ações:

Criar uma política

Importante

Atualmente, atualizar ou modificar uma política existente não é suportado. Em alternativa, pode criar uma nova política com os detalhes necessários e atribuí-la à instância de backup relevante.

Para criar uma política de Azure Backup, utilize 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 fornecidos no URI. Informações adicionais são fornecidas no órgão de pedido.

Criar o corpo de pedido

Por exemplo, para criar uma política de backup de discos, o organismo de pedido precisa dos seguintes componentes:

Name Necessário Tipo Description
propriedades Verdadeiro BaseBackupPolicy:BackupPolicy Propriedades baseBackupPolicyResource

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

Corpo de pedido de exemplo

A política diz:

  • Gatilho programado para cada 4 horas (PT4H). Em seguida, os backups são tomados aproximadamente no intervalo de cada 4 horas para que os backups sejam distribuídos igualmente ao longo do dia.
  • Pode escolher o intervalo do gatilho a cada 4, 6, 8 ou 12 horas. Para agendar uma cópia de segurança uma vez por dia, utilize o P1D. As cópias de segurança são acionadas uma vez por dia na hora estipulada.
  • A Datastore é uma loja operacional, uma vez que as cópias de segurança são locais, e nenhum dado é armazenado no cofre de reserva. Na loja operacional, cada instância de backup é armazenada durante sete dias (P7D).
{
"properties": {
    "datasourceTypes": [
        "Microsoft.Compute/disks"
      ],
      "name": "DiskPolicy",
      "objectType": "BackupPolicy",
      "policyRules": [
        {
          "backupParameters": {
            "backupType": "Incremental",
            "objectType": "AzureBackupParams"
          },
          "dataStore": {
            "dataStoreType": "OperationalStore",
            "objectType": "DataStoreInfoBase"
          },
          "name": "BackupHourly",
          "objectType": "AzureBackupRule",
          "trigger": {
            "objectType": "ScheduleBasedTriggerContext",
            "schedule": {
              "repeatingTimeIntervals": [
                "R/2020-04-05T13:00:00+00:00/PT4H"
              ]
            },
            "taggingCriteria": [
              {
                "isDefault": true,
                "tagInfo": {
                  "id": "Default_",
                  "tagName": "Default"
                },
                "taggingPriority": 99
              }
            ]
          }
        },
        {
          "isDefault": true,
          "lifecycles": [
            {
              "deleteAfter": {
                "duration": "P7D",
                "objectType": "AbsoluteDeleteOption"
              },
              "sourceDataStore": {
                "dataStoreType": "OperationalStore",
                "objectType": "DataStoreInfoBase"
              }
            }
          ],
          "name": "Default",
          "objectType": "AzureRetentionRule"
        }
      ]
    }
}

Importante

Os formatos de tempo suportam apenas o DateTime. Não apoiam apenas o tempo. A hora do dia indica a hora de início de reserva e não a hora em que a cópia de segurança termina.

O tempo necessário para completar a operação de backup depende de vários fatores, incluindo o tamanho do disco, e a taxa de churn entre cópias de segurança consecutivas. No entanto, o Azure Disk Backup é uma cópia de segurança sem agente que utiliza instantâneos incrementais, o que não afeta o desempenho da aplicação de produção.

Para saber mais detalhes sobre a criação de políticas, consulte o documento de política de backup do disco Azure .

Respostas

A criação/atualização da política de backup é uma operação sincronizada e retorna OK assim que a operação for bem sucedida.

Nome Tipo Description
200 OK BaseBackupPolicyResource OK

Respostas de exemplo

Uma vez concluída a operação, devolve 200 (OK) com o conteúdo da política no organismo de resposta.

{
    "id": "/subscriptions/73307177-bb00-4801-bd11-894b2f2d5162/resourceGroups/RG-BV/providers/Microsoft.DataProtection/backupVaults/BV-JPE-GRS/backupPolicies/DiskBackupPolicy-03",
    "name": "DiskBackupPolicy-03",
    "type": "Microsoft.DataProtection/backupVaults/backupPolicies",
    "properties": {
        "policyRules": [
            {
                "backupParameters": {
                    "backupType": "Incremental",
                    "objectType": "AzureBackupParams"
                },
                "trigger": {
                    "schedule": {
                        "repeatingTimeIntervals": [
                            "R/2021-07-01T19:00:00+00:00/P1D"
                        ],
                      },
                    "taggingCriteria": [
                        {
                            "tagInfo": {
                                "tagName": "Default",
                                "id": "Default_"
                            },
                            "taggingPriority": 99,
                            "isDefault": true
                        }
                    ],
                    "objectType": "ScheduleBasedTriggerContext"
                },
                "dataStore": {
                    "dataStoreType": "OperationalStore",
                    "objectType": "DataStoreInfoBase"
                },
                "name": "BackupDaily",
                "objectType": "AzureBackupRule"
            },
            {
                "lifecycles": [
                    {
                        "deleteAfter": {
                            "objectType": "AbsoluteDeleteOption",
                            "duration": "P7D"
                        },
                        "targetDataStoreCopySettings": [],
                        "sourceDataStore": {
                            "dataStoreType": "OperationalStore",
                            "objectType": "DataStoreInfoBase"
                        }
                    }
                ],
                "isDefault": true,
                "name": "Default",
                "objectType": "AzureRetentionRule"
            }
        ],
        "datasourceTypes": [
            "Microsoft.Compute/disks"
        ],
        "objectType": "BackupPolicy"
    }
}

Passos seguintes

Permitir proteção para discos Azure

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