Undelete Blob

La Undelete Blob operación restaura el contenido y los metadatos de un blob eliminado temporalmente y las instantáneas eliminadas temporalmente asociadas.

Undelete Blob solo se admite en la versión 2017-07-29 o posterior.

Solicitud

La solicitud Undelete Blob se puede construir como sigue. Se recomienda HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento:

URI de solicitud del método PUT Versión HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=undelete HTTP/1.1

URI de servicio de almacenamiento emulado

Al realizar una solicitud en el servicio de almacenamiento emulado, especifique el nombre de host del emulador y el puerto del servicio Blob como 127.0.0.1:10000, seguido del nombre de la cuenta de almacenamiento emulado:

URI de solicitud del método PUT Versión HTTP
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=undelete HTTP/1.1

Para obtener más información, vea Using the Azure Storage Emulator for Development and Testing.

Parámetros de identificador URI

Se pueden especificar los parámetros adicionales siguientes en el URI de solicitud.

Parámetro Descripción
timeout Opcional. El parámetro timeout se expresa en segundos. Para obtener más información, vea Establecer tiempos de espera para las operaciones de Blob Service.

Encabezados de solicitud (todos los tipos de blob)

En la tabla siguiente se describen los encabezados de solicitud obligatorios y opcionales para todos los tipos de blob.

Encabezado de solicitud Descripción
Authorization Necesario. Especifica el esquema de autorización, el nombre de cuenta y la firma. Para obtener más información, vea Authorize requests to Azure Storage.
Date o x-ms-date Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Authorize requests to Azure Storage.
x-ms-version Obligatorio para todas las solicitudes autorizadas. Especifica la versión de la operación que se utiliza para esta solicitud. Para obtener más información, vea Control de versiones de Azure Storage Services.
x-ms-undelete-source Opcional. Versión 2020-08-04 y versiones más recientes. Solo para las cuentas con cuentas habilitadas para espacio de nombres jerárquico. Ruta de acceso del blob eliminado temporalmente que se recuperará. El formato es blobPath?deletionid=<id> o blobPath?snapshot=<DateTime>&deletionid=<id>. La cuenta y el nombre del contenedor no se incluyen en la ruta de acceso. DeletionId es el identificador único del blob eliminado temporalmente. Se puede recuperar enumerando los blobs eliminados temporalmente con la API REST List Blobs para cuentas habilitadas para espacio de nombres jerárquico. El parámetro snapshot es un valor datetime opaco que, cuando está presente, especifica la instantánea eliminada temporalmente que se va a recuperar. La ruta de acceso debe estar codificada por porcentaje.
x-ms-client-request-id Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 KiB que se registra en los registros de análisis cuando se habilita el registro de análisis de almacenamiento. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor. Para más información, consulte Acerca del Storage Analytics y Registro de Azure: Uso de registros para realizar un seguimiento de las solicitudes de almacenamiento.

Cuerpo de la solicitud

Ninguno.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Código de estado

Una operación correcta devuelve el código de estado 200 Correcto.

Para obtener información sobre los códigos de estado, vea Códigos de estado y de error.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.

Sintaxis Descripción
x-ms-request-id Este encabezado identifica de forma única la solicitud que se realizó y se puede utilizar para solucionar problemas relacionados con esta. Para más información, consulte Solución de problemas de operaciones de API.
x-ms-version Indica la versión del servicio Blob utilizado para ejecutar la solicitud.
Date Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta.
x-ms-client-request-id Este encabezado se puede usar para solucionar problemas de solicitudes y respuestas correspondientes. El valor de este encabezado es igual al valor del encabezado si está presente en la solicitud y el valor tiene como máximo x-ms-client-request-id 1024 caracteres ASCII visibles. Si el x-ms-client-request-id encabezado no está presente en la solicitud, este encabezado no estará presente en la respuesta.

Cuerpo de la respuesta

Ninguno.

Authorization

La llamada a esta operación solo la puede realizar el propietario de la cuenta y cualquiera que disponga de una firma de acceso compartido con permiso para escribir en el blob o en su contenedor.

Comentarios

Cuando se recupera un blob eliminado temporalmente, el blob y las instantáneas asociadas están disponibles para las operaciones que usan otras API. Recupere la solicitud al blob, recupere el blob eliminado temporalmente y las instantáneas de eliminación temporal asociadas. Si intenta recuperar un blob que no se elimina temporalmente ni tiene ninguna instantánea eliminada temporalmente, se realizará correctamente sin ningún cambio.

Consulte también

Autorización de solicitudes para Azure Storage
Estado y códigos de error Eliminar blob