Actualización de la configuración del almacén de Azure Recovery Services mediante la API REST

  • Artículo

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.

Estado de eliminación temporal

La eliminación de las copias de seguridad de un elemento protegido es una operación importante que debe supervisarse. 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, de ser necesario, dentro de un período de tiempo posterior a la eliminación.

Sin embargo, hay escenarios en los que esta funcionalidad no es necesaria. No es posible eliminar un almacén de Azure Recovery Services si contiene elementos de copia de seguridad, incluso si tienen el estado de eliminación temporal. 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, eliminar 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, debe elegir cuidadosamente si quiere deshabilitar la eliminación temporal para un almacén determinado en función del escenario. Para obtener más información, consulte el artículo sobre la eliminación temporal.

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 de GET tiene los parámetros {subscriptionId}, {vaultName} y {vaultresourceGroupName}. En este ejemplo, {vaultName} es "testVault" y {vaultresourceGroupName} es "testVaultRG". Como todos los parámetros necesarios se proporcionan en el URI, no hay necesidad de tener un cuerpo de solicitud independiente.

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Respuestas

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

Nombre Type Descripción
200 OK BackupResourceVaultConfig Aceptar
Respuesta de ejemplo

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

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/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 eliminación temporal mediante la API REST

Para actualizar el estado de eliminación temporal del almacén de Recovery Services con 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 de PUT tiene los parámetros {subscriptionId}, {vaultName} y {vaultresourceGroupName}. En este ejemplo, {vaultName} es "testVault" y {vaultresourceGroupName} es "testVaultRG". Si reemplazamos el URI con los valores anteriores, el URI tendrá el siguiente aspecto.

PUT https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Creación del cuerpo de la solicitud

Para crear el cuerpo de la solicitud, se usan las siguientes definiciones comunes.

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

Nombre Obligatorio Tipo Descripción
eTag String eTag opcional
ubicación true String Ubicación de los recursos
properties VaultProperties Propiedades del almacén
etiquetas Object Etiquetas del recurso

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 Type Descripción
200 OK BackupResourceVaultConfig Aceptar
Respuesta de ejemplo para la operación PATCH

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

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Pasos siguientes

Creación de una directiva de copia de seguridad para la copia de seguridad de una máquina virtual de Azure en este almacén.

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