Criar políticas de cópia de segurança do Azure Data Protection para discos com a API REST
Este artigo descreve como criar uma política de cópia de segurança através da API REST.
O Azure Disk Backup oferece uma solução chave na mão que fornece a gestão do ciclo de vida de instantâneos para discos geridos ao automatizar a criação periódica de instantâneos e retê-lo durante a duração configurada com a política de cópia de segurança. Pode gerir os instantâneos do disco sem custos de infraestrutura e sem a necessidade de scripts personalizados ou qualquer sobrecarga de gestão. Esta é uma solução de cópia de segurança consistente com falhas que utiliza cópias de segurança pontuais de um disco gerido através de instantâneos incrementais com suporte para várias cópias de segurança por dia. Também é uma solução sem agente e não afeta o desempenho da aplicação de produção. Suporta a cópia de segurança e o restauro de discos de SO e de dados (incluindo discos partilhados), quer estejam ou não ligados a uma máquina virtual do Azure em execução.
A política de cópia de segurança ajuda a governar a retenção e a agenda das suas cópias de segurança. A política de cópia de segurança oferece várias cópias de segurança por dia. Pode reutilizar a política de cópia de segurança para configurar a cópia de segurança de vários Discos do Azure para um cofre ou criar uma política de cópia de segurança para um cofre dos Serviços de Recuperação do Azure com a API REST.
Para criar uma política para criar cópias de segurança de discos, execute as seguintes ações:
Criar uma política
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
Os {policyName} e {vaultName} são fornecidos no URI. São fornecidas informações adicionais no corpo do pedido.
Importante
Atualmente, a atualização ou modificação de uma política existente não é suportada. Em alternativa, pode criar uma nova política com os detalhes necessários e atribuí-la à instância de cópia de segurança relevante.
Criar o corpo do pedido
Por exemplo, para criar uma política de cópia de segurança do disco, o corpo do 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 corpo do pedido, veja o documento da API REST da política de cópia de segurança.
Corpo do pedido de exemplo
A política diz:
- Acionador agendado para cada 4 horas (PT4H). Em seguida, as cópias de segurança são efetuadas aproximadamente no intervalo de cada 4 horas para que as cópias de segurança sejam distribuídas igualmente ao longo do dia.
- Pode escolher o intervalo de acionador a cada 4, 6, 8 ou 12 horas. Para agendar uma cópia de segurança como uma vez por dia, utilize p1D. As cópias de segurança são acionadas uma vez por dia na hora estipulada.
- O Arquivo de Dados é um arquivo operacional, uma vez que as cópias de segurança são locais e não são armazenados dados no Cofre de cópias de segurança. No arquivo operacional, cada instância de cópia de segurança é 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 hora suportam apenas DateTime. Não suportam apenas o Tempo. A hora do dia indica a hora de início da cópia de segurança e não a hora em que a cópia de segurança é concluída.
O tempo necessário para concluir a operação de cópia de segurança depende de vários fatores, incluindo o tamanho do disco, e da taxa de abandono 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, veja o documento de política do Azure Disk Backup .
Respostas
A criação/atualização da política de cópia de segurança é uma operação síncrona e devolve OK assim que a operação for concluída com êxito.
| Nome | Tipo | Description |
|---|---|---|
| 200 OK | BaseBackupPolicyResource | OK |
Respostas de exemplo
Assim que a operação for concluída, devolve 200 (OK) com o conteúdo da 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"
}
}
Passos seguintes
Ativar a proteção para discos do Azure
Para obter mais informações sobre as APIs REST Azure Backup, veja os seguintes artigos: