Compartir vía

Actualiza las configuraciones de la bóveda de Azure Recovery Services utilizando la API REST

En este artículo se describe cómo actualizar las configuraciones relacionadas con la copia de seguridad en el almacén de Azure Recovery Services mediante la API REST.

Administración de operaciones de eliminación temporal en el almacén de Recovery Services

La eliminación de copias de seguridad de un elemento protegido es una operación significativa que se debe supervisar. Para protegerse contra eliminaciones accidentales, el almacén de Azure Recovery Services tiene una funcionalidad de eliminación temporal. Esta funcionalidad le permite restaurar las copias de seguridad eliminadas, si es necesario, dentro de un período de tiempo después de la eliminación.

Pero hay escenarios en los que esta funcionalidad no es necesaria. No se puede eliminar un almacén de Azure Recovery Services si hay elementos de copia de seguridad dentro de él, incluso los eliminados temporalmente. Esto puede suponer un problema si el almacén debe eliminarse inmediatamente. Por ejemplo: las operaciones de implementación a menudo limpian los recursos creados en el mismo flujo de trabajo. Una implementación puede crear un almacén, configurar copias de seguridad para un elemento, realizar una restauración de prueba y, a continuación, continuar con la eliminación de los elementos de copia de seguridad y el almacén. Si se produce un error en la eliminación del almacén, se puede producir un error en toda la implementación. Deshabilitar la eliminación temporal es la única manera de garantizar la eliminación inmediata.

Por lo tanto, deberá elegir cuidadosamente si desea desactivar la función de borrado suave para un determinado almacén en función del escenario. Aprende más sobre la eliminación suave.

Recuperación del estado de eliminación temporal mediante la API REST

De forma predeterminada, el estado de eliminación temporal se habilitará para los almacenes de Recovery Services recién creados. Para recuperar o actualizar el estado de la eliminación temporal de un almacén, use el documento de API REST relacionado con la configuración del almacén de copia de seguridad.

Para recuperar el estado actual de la eliminación temporal de un almacén, use la siguiente operación GET.

GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

El URI GET tiene los parámetros {subscriptionId}, {vaultName} y {vaultresourceGroupName}. En este ejemplo, {vaultName} es "testVault" y {vaultresourceGroupName} es "testVaultRG". Dado que todos los parámetros necesarios se proporcionan en el URI, no es necesario un cuerpo de solicitud independiente.

GET https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Responses

A continuación se muestra la respuesta correcta para la operación 'GET':

Nombre Tipo Description
200 Ok BackupResourceVaultConfig OK
Respuesta de ejemplo

Una vez enviada la solicitud "GET", se devuelve una respuesta 200 (correcta).

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Enabled"
  }
}

Actualización del estado de "soft delete" mediante la API REST

Para actualizar el estado de eliminación suave de la bóveda de servicios de recuperación mediante la API REST, use la siguiente operación PUT.

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

El URI PUT tiene los parámetros {subscriptionId}, {vaultName}, {vaultresourceGroupName}. En este ejemplo, {vaultName} es "testVault" y {vaultresourceGroupName} es "testVaultRG". Si reemplazamos el URI por los valores anteriores, el URI tendrá este aspecto.

PUT https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Creación del cuerpo de la solicitud

Las siguientes definiciones comunes se usan para crear un cuerpo de solicitud.

Para más información, consulte la documentación de la API REST.

Nombre Obligatorio Tipo Description
eTag String ETag opcional
location true String Ubicación de los recursos
Propiedades VaultProperties Propiedades del almacén
tags Objeto Etiquetas de recursos

Cuerpo de solicitud de ejemplo

El ejemplo siguiente se usa para actualizar el estado de eliminación temporal al estado deshabilitado.

{
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Respuestas para la operación PATCH

A continuación se muestra la respuesta correcta para la operación 'PATCH':

Nombre Tipo Description
200 Ok BackupResourceVaultConfig OK
Respuesta de ejemplo para la operación PATCH

Una vez que se emite la solicitud "PATCH", se devuelve una respuesta 200 (correcta).

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Pasos siguientes

Cree una directiva de copia de seguridad para realizar una copia de seguridad de una máquina virtual de Azure en esta bóveda.

Para más información sobre las API REST de Azure, consulte los siguientes documentos:

  • Last updated on