Delete Blob

  • Artículo
  • Tiempo de lectura: 7 minutos

La operación Delete Blob marca para su eliminación la instantánea o el blob especificado. El blob se elimina posteriormente durante la recolección de elementos no utilizados.

Tenga en cuenta que para eliminar un blob, debe eliminar todas sus instantáneas. Puede eliminar ambos elementos al mismo tiempo con la operación Delete Blob.

Solicitud

La solicitud Delete 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 DELETE Versión HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>		 HTTP/1.1

URI del 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 DELETE Versión HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

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

Parámetros de URI

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

Parámetro Descripción
snapshot Opcional. El parámetro de instantánea es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a eliminar. Para más información sobre cómo trabajar con instantáneas de blob, consulte Creación de una instantánea de un blob.
versionid Opcional, versión 2019-12-12 y versiones más recientes. El parámetro versionid es un valor opaco que, cuando está presente, especifica DateTime la versión del blob que se va a eliminar.
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.
deletetype Opcional, versión 2020-02-10 o posterior. El valor de deletetype solo puede ser permanent . Para obtener más información, vea Comentarios a continuación.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud Descripción
Authorization Obligatorio. 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 Obligatorio. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Authorize requests to Azure Storage.
x-ms-version Se requiere para todas las solicitudes autorizadas. Para obtener más información, vea Control de versiones de Azure Storage Services.
x-ms-lease-id:<ID> Obligatorio si el blob tiene una concesión activa.

Para realizar esta operación en un blob con una concesión activa, especifique el identificador de concesión válido de este encabezado. Si en la solicitud no se especifica un identificador de concesión válido, se producirá un error con el código de estado 403 (Forbidden).
x-ms-delete-snapshots: {include, only} Obligatorio si el blob tiene instantáneas asociadas. Especifique una de las dos opciones siguientes:

- include: elimine el blob base y todas sus instantáneas.
- only: elimine solo las instantáneas del blob y no el propio blob.

Este encabezado se debe especificar solo cuando la solicitud se realiza en el recurso de blob de base. Si el encabezado se especifica en una solicitud de eliminación de una instantánea individual, el servicio Blob devuelve el código de estado 400 (Solicitud incorrecta).

Si el encabezado no se especifica en la solicitud y el blob tiene instantáneas asociadas, Blob service devuelve el código de estado 409 (Conflicto).
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 registro Storage Analytics y registro de Azure: Uso de registros para realizar un seguimiento Storage solicitudes.

Esta operación también admite el uso de encabezados condicionales que permiten eliminar el blob solo si se cumple una condición especificada. Para obtener más información, consulte Especificación de encabezados condicionales para las operaciones de Blob Service.

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 202 (Aceptado).

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.

Encabezado de respuesta 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. Este encabezado se devuelve para las solicitudes realizadas en la versión 2009-09-19 y versiones posteriores.
x-ms-delete-type-permanent Para las versiones 2017-07-29 y posteriores, el Blob service devuelve true si el blob se ha eliminado permanentemente y false si el blob se ha eliminado temporalmente.
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.

Autorización

Esta operación la puede realizar el propietario de la cuenta o cualquiera que utilice una firma de acceso compartido con permiso para eliminar el blob.

Comentarios

Si el blob tiene una concesión activa, el cliente debe especificar un identificador de concesión válido en la solicitud para poder eliminarlo.

Si un blob tiene un gran número de instantáneas, es posible que la operación se Delete Blob desalome. Si esto sucede, el cliente debe reintentar la solicitud.

En la versión 2013-08-15 y posteriores, el cliente puede llamar a Delete Blob para eliminar blobs sin confirmar. Un blob no confirmado es un blob que se creó con llamadas a la operación Put Block, pero que nunca se ha confirmado mediante la operación Put Block List. En las versiones anteriores, el cliente debe confirmar primero el blob antes de eliminarlo.

Característica de eliminación temporal deshabilitada

Cuando un blob se elimina correctamente, se quita inmediatamente del índice de la cuenta de almacenamiento para que los clientes no puedan volver a tener acceso a él. Los datos del blob se quitan más tarde del servicio, durante la recolección de elementos no utilizados.

Característica de eliminación automática habilitada

Cuando un blob se elimina correctamente, se elimina temporalmente y ya no es accesible para los clientes. El Blob service conserva el blob o la instantánea durante el número de días especificado para la propiedad DeleteRetentionPolicy de la Blob service. Para obtener información sobre cómo leer Blob service propiedades, vea Establecer las propiedades de Blob Service.

Después del número de días especificado, los datos del blob se quitan del servicio durante la recolección de elementos no utilizados. Se puede acceder a un blob o una instantánea eliminados temporalmente llamando a la operación List Blobs y especificando la include=deleted opción .

El blob o la instantánea eliminados temporalmente se pueden restaurar mediante Undelete Blob.

Para cualquier otra operación en blobs o instantáneas eliminados temporalmente, Blob Service devuelve el error 404 (ResourceNotFound).

Eliminación permanente

Se ha agregado una característica para eliminar permanentemente una instantánea o versión en delete blob API con la versión 2020-02-10 y posteriores. Para aprovechar la característica, la cuenta de almacenamiento debe tener habilitada la eliminación permanente. Para obtener más información, vea Establecer las propiedades de Blob Service.

Storage cuentas con la eliminación permanente habilitada puede usar el parámetro de consulta para eliminar permanentemente una instantánea eliminada temporalmente o deletetype=permanent una versión de blob eliminada. Blob service devolvería 409 (conflicto) si el parámetro de consulta presenta cualquiera de los siguientes elementos:

  • La eliminación permanente no está habilitada para la cuenta de almacenamiento.
  • No versionid se proporcionan ni snapshot .
  • La instantánea o la versión especificadas no se eliminan (temporalmente).

La eliminación permanente también incluye un nuevo permiso de SAS (y) conceder permiso para eliminar permanentemente una instantánea de blob o una versión de blob. Para más información, consulte Creación de una SAS de servicio.

Consulte también

Autorización de solicitudes para Azure Storage
Códigos de estado y error
Códigos de error de Blob Service Para recuperar blobs de la lista de blobs