Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este artigo descreve como criar uma política de backup via API REST.
O Azure Disk Backup oferece uma solução pronta para uso que fornece gerenciamento do ciclo de vida de instantâneos para discos gerenciados, automatizando a criação periódica de instantâneos e retendo-os por tempo configurado usando a política de backup. Você pode gerenciar os instantâneos de disco sem custo de infraestrutura e sem a necessidade de scripts personalizados ou qualquer sobrecarga de gerenciamento. Esta é uma solução de backup consistente em caso de falhas que realiza cópias de segurança em um determinado momento de um disco gerido, usando snapshots incrementais com suporte para vários backups por dia. Também é uma solução sem agente e não afeta o desempenho do aplicativo de produção. Ele dá suporte ao backup e à restauração de discos de sistema operacional e de dados (incluindo discos compartilhados), estejam eles conectados ou não 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 para 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 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. Informações adicionais são fornecidas no corpo do pedido.
Importante
Atualmente, não há suporte para atualizar ou modificar uma política existente. Como alternativa, 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 em disco, o corpo da solicitação precisa dos seguintes componentes:
| Nome | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| propriedades | Verdadeiro | BaseBackupPolicy:BackupPolicy | Propriedades de BaseBackupPolicyResource |
Para obter a lista completa de definições no corpo do pedido, consulte o documento da API REST da política de backup.
Exemplo de corpo da solicitação
A política diz:
- Gatilho programado a cada 4 horas (PT4H). Em seguida, os backups são feitos aproximadamente no intervalo de cada 4 horas para que os backups sejam distribuídos igualmente ao longo do dia.
- Você pode escolher o intervalo de gatilho a cada 4, 6, 8 ou 12 horas. Para agendar um backup como uma vez por dia, use P1D. Os backups são acionados uma vez por dia no horário estipulado.
- O armazenamento de dados é um armazenamento 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 suportam apenas DateTime. Eles não apoiam apenas o Tempo. A hora do dia indica a hora de início do backup e não a hora em que o backup é concluído.
O tempo necessário para concluir a operação de backup depende de vários fatores, incluindo o tamanho do disco e a taxa de 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, consulte o documento de política de backup de disco do Azure.
Nota
- Para os Discos do Azure das gamas HDD Standard, SSD Standard e SSD Premium, pode definir o agendamento de backup com frequência horária (de 1, 2, 4, 6, 8 ou 12 horas) e frequência diária.
- Para Discos do Azure pertencentes a SKUs Premium V2 e Ultra Disk, você pode definir o agendamento de backup com frequência horária de apenas 12 horas e frequência diária .
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 | Tipo | Descrição |
|---|---|---|
| 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/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óximos passos
Habilitar a proteção para Discos do Azure
Para obter mais informações sobre as APIs REST do Backup do Azure, consulte os seguintes artigos: