Compartir a través de

Creación de directivas de copia de seguridad de protección de datos de Azure para discos mediante la API de REST

En este artículo se describe cómo crear una directiva de copia de seguridad a través de la API de REST.

Azure Disk Backup ofrece una solución de tipo "llave en mano" que le proporciona la oportunidad de administrar el ciclo de vida de las instantáneas para los discos administrados; para ello, solo debe automatizar la creación periódica de instantáneas y guardarlas durante la duración configurada mediante la directiva de copia de seguridad. Puede administrar las instantáneas de disco sin costos de infraestructura, sin necesidad de realizar un scripting personalizado y sin sufrir ninguna sobrecarga de administración. Esta solución de copia de seguridad coherente con los bloqueos realiza en un momento dado una copia de seguridad de un disco administrado mediante instantáneas incrementales, y admite la realización de varias copias de seguridad al día. También es una solución sin agente que no afecta al rendimiento de las aplicaciones de producción. Igualmente, admite las copias de seguridad y la restauración de los discos de datos y del sistema operativo (incluidos los discos compartidos), tanto si están conectados actualmente a una máquina virtual de Azure en ejecución como si no.

La directiva de copia de seguridad ayuda a regir la retención y la programación de las copias de seguridad. También ofrece varias copias de seguridad al día. Puede reutilizar la directiva de copia de seguridad para configurar la copia de seguridad de varios discos de Azure en un almacén o crear una directiva de copia de seguridad para un almacén de Azure Recovery Services mediante la API de REST.

Para crear una directiva de copia de seguridad de discos, realice las siguientes acciones:

Crear una directiva

Para crear una directiva de Azure Backup, use la siguiente operación PUT:

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies/{policyName}?api-version=2021-01-01

Los valores de {policyName} y {vaultName} se proporcionan en el URI. Se proporciona información adicional en el cuerpo de la solicitud.

Importante

Actualmente, no se admite la actualización o modificación de una directiva existente. Una alternativa es crear una directiva con los detalles necesarios y asignarla a la instancia de copia de seguridad correspondiente.

Creación del cuerpo de la solicitud

Por ejemplo, para crear una directiva para la copia de seguridad en disco, el cuerpo de la solicitud necesita los siguientes componentes:

Nombre Obligatorio Tipo Descripción
properties True BaseBackupPolicy:BackupPolicy Propiedades BaseBackupPolicyResource

Para obtener una lista completa de las definiciones en el cuerpo de la solicitud, consulte el documento de la directiva de copia de seguridad de API REST.

Cuerpo de solicitud de ejemplo

La directiva indica:

  • Desencadenador programado cada 4 horas (PT4H). Las copias de seguridad se realizan aproximadamente cada 4 horas, por lo que estas se distribuyen equitativamente a lo largo del día.
  • Puede elegir que el intervalo de desencadenador cada 4, 6, 8 o 12 horas. Para programar una copia de seguridad una vez al día, use P1D. Las copias de seguridad se desencadenan una vez al día a la hora estipulada.
  • El almacén de datos es el almacén operativo, ya que las copias de seguridad son locales y no se almacenan datos en el almacén de Backup. En el almacén operativo, cada instancia de copia de seguridad se almacena durante siete días (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

Los formatos de fecha y hora admiten solo el valor DateTime. No admiten solo el valor Time. Recuerde que la hora del día indica la hora de inicio de la copia de seguridad, no la hora en que se completa la misma.

El tiempo necesario para completar la operación de copia de seguridad depende de varios factores, como el tamaño del disco y la tasa de renovación entre copias de seguridad consecutivas. No obstante, la copia de seguridad de discos de Azure es una opción de copias de seguridad sin agente que usa instantáneas incrementales, lo que no afecta al rendimiento de la aplicación de producción.

Para más información sobre la creación de directivas, consulte el documento Creación de una directiva de copia de seguridad.

Nota:

  • En el caso de los discos de Azure pertenecientes a las SKU HDD estándar, SSD estándar y SSD prémium, puede definir la programación de la copia de seguridad con frecuencia horaria (de 1, 2, 4, 6, 8 o 12 horas) y frecuencia diaria.
  • En el caso de los discos de Azure que pertenecen a las SKU premium V2 y SSD Ultra, puede definir la programación de copia de seguridad con una frecuencia horaria de solo 12 horas y una frecuencia diaria.

Respuestas

La creación o actualización de la directiva de copia de seguridad es una operación sincrónica y devuelve Correcta una vez que la operación se realiza correctamente.

Nombre Escribir Descripción
200 OK BaseBackupPolicyResource Aceptar

Respuestas de ejemplo

Una vez completada la operación, devuelve 200 (OK) con el contenido de la directiva en el cuerpo de respuesta.

{
    "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"
    }
}

Pasos siguientes

Habilitación de la protección para Azure Disks

Para obtener más información sobre las API de REST de Azure Backup, consulte los siguientes artículos: