Actualización de la configuración del almacén de Azure Recovery Services mediante 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.
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, deberá elegir cuidadosamente si desea desactivar la función de borrado suave para un determinado almacén en función del escenario. Más información 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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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 | Escribir | 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/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 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/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
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 | Type | 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 | Escribir | 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/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
Para más información sobre las API REST de Azure, consulte los siguientes documentos:
- API REST del proveedor de Azure Recovery Services
- Get started with Azure REST API (Introducción a la API REST de Azure)