Criar políticas de backup da Proteção de Dados do Azure para discos usando a API REST
Este artigo descreve como criar uma política de backup por meio da API REST.
O Backup de Disco do Azure oferece uma solução turnkey que fornece gerenciamento de ciclo de vida por instantâneos para o discos gerenciados ao automatizar a criação periódica de instantâneos e retê-los pela duração configurada usando a política de backup. É possível gerenciar os instantâneos de disco com custo zero de infraestrutura e sem a necessidade de script personalizado ou qualquer sobrecarga no gerenciamento. É uma solução de backup consistente por falha, que faz o backup pontual de um disco gerenciado usando instantâneos incrementais com suporte para vários backups por dia. Também é uma solução sem agente e não afeta o desempenho do aplicativo em produção. E compatível com backup e restauração de sistemas operacionais e de discos de dados (incluindo discos compartilhados), independentemente de estarem ou não conectados a uma máquina virtual do Azure em execução.
A política de backup ajuda a controlar a retenção e o agendamento de seus backups. A política de backup oferece vários backups por dia. Você pode reutilizar a política de backup para configurar o backup de vários Discos do Azure em um cofre ou criar uma política de backup para um cofre dos Serviços de Recuperação do Azure usando a API REST.
Para criar uma política para fazer backup de discos, execute as seguintes ações:
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. Informações adicionais são fornecidas no corpo da solicitação.
Importante
Atualmente, não há compatibilidade com a atualização ou modificação de uma política existente. Como alternativa, é 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 Discos, o corpo da solicitação precisa dos seguintes componentes:
| Nome | Obrigatório | Type | Descrição |
|---|---|---|---|
| properties | True | BaseBackupPolicy:BackupPolicy | Propriedades BaseBackupPolicyResource |
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 do corpo de solicitação
A diretiva diz:
- Gatilho agendado para cada 4 horas (PT4H). Então, os backups serão feitos aproximadamente no intervalo de cada 4 horas para que sejam distribuídos igualmente ao longo do dia.
- Você pode escolher o intervalo de gatilho para ser a cada 4, 6, 8 ou 12 horas. Para agendar um backup uma vez por dia, use P1D. Os backups são disparados uma vez por dia no horário estipulado.
- O armazenamento de dados é repositório operacional, pois os backups são locais e nenhum dado é armazenado no cofre de Backup. No armazenamento operacional, cada instância de backup é armazenada por 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 hora possuem suporte apenas para datetime. Eles não possuem suporte para somente Time. A hora do dia indica o horário de início do backup, e não o horário em que o backup é concluído.
O tempo necessário para concluir a operação de backup depende de vários fatores, como o tamanho do disco e a rotatividade entre backups consecutivos. No entanto, o backup de disco do Azure é um backup sem agente que usa instantâneos incrementais, o que não afeta o desempenho do aplicativo de produção.
Para saber mais detalhes sobre a criação de políticas, confira o documento Política de backup de disco do Azure.
Respostas
A criação/atualização da política de backup é uma operação síncrona e retorna OK quando a operação é bem-sucedida.
| Nome | Type | 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/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"
}
}
Próximas etapas
Habilitar a proteção para Discos do Azure
Para obter mais informações sobre as APIs REST do Backup do Azure, confira os seguintes artigos: