Compartir a través de


Delete Blob

La Delete Blob operación elimina el blob o la instantánea especificados.

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

Puede construir la solicitud de la Delete Blob siguiente manera. Se recomienda HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento.

URI de solicitud de método DELETE Versión de 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 Azure Blob Storage puerto como 127.0.0.1:10000, seguido del nombre de la cuenta de almacenamiento emulada.

URI de solicitud de método DELETE Versión de HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

Para más información, consulte Uso del emulador de Azurite para el desarrollo local de Azure Storage.

Parámetros del identificador URI

Puede especificar los siguientes parámetros adicionales 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 posteriores. El versionid parámetro es un valor opaco DateTime que, cuando está presente, especifica la versión del blob que se va a eliminar.
timeout Opcional. El parámetro timeout se expresa en segundos. Para más información, consulte Establecimiento de tiempos de espera para las operaciones de Blob Storage.
deletetype Opcional, versión 2020-02-10 o posterior. El valor de deletetype solo puede ser permanent.

Encabezados de solicitud

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

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 Autorización de solicitudes a Azure Storage.
Date o x-ms-date Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
x-ms-version Necesario para todas las solicitudes autorizadas. Para obtener más información, vea Versiones de los servicios de Azure Storage.
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 no se especifica un identificador de concesión válido en la solicitud, se produce un error en la operación con el código de estado 403 (Prohibido).
x-ms-delete-snapshots: {include, only} Obligatorio si el blob tiene instantáneas asociadas. Especifique una de las siguientes opciones:

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

Especifique este encabezado solo para una solicitud en el recurso de blob base. Si se especifica este encabezado en una solicitud para eliminar una instantánea individual, Blob Storage devuelve el código de estado 400 (solicitud incorrecta).

Si no se especifica este encabezado en la solicitud y el blob tiene instantáneas asociadas, Blob Storage 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 kibibyte (KiB) que se registra en los registros cuando se configura el registro. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes que recibe el servidor. Para obtener más información, consulte Supervisión de Azure Blob Storage.

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 más información, consulte Especificación de encabezados condicionales para las operaciones de Blob Storage.

Cuerpo de la solicitud

Ninguno.

Response

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

status code

Una operación correcta devuelve el código de estado 202 (Aceptado). Para obtener información sobre los códigos de estado, consulte Códigos de estado y error.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir encabezados HTTP adicionales 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 usar para solucionar problemas de la solicitud. Para más información, consulte Solución de problemas de operaciones de API.
x-ms-version Indica la versión de Blob Storage usada 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 la versión 2017-07-29 y posteriores, Blob Storage 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 que indica la hora en la que se inició la respuesta. El servicio genera este valor.
x-ms-client-request-id Puede usar este encabezado para solucionar problemas de solicitudes y respuestas correspondientes. El valor de este encabezado es igual al valor del x-ms-client-request-id encabezado, si está presente en la solicitud. El valor tiene como máximo 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.

Authorization

La autorización es necesaria al llamar a cualquier operación de acceso a datos en Azure Storage. Puede autorizar la Delete Blob operación como se describe a continuación.

Importante

Microsoft recomienda usar Microsoft Entra ID con identidades administradas para autorizar solicitudes a Azure Storage. Microsoft Entra ID proporciona una mayor seguridad y facilidad de uso en comparación con la autorización de clave compartida.

Azure Storage admite el uso de Microsoft Entra ID para autorizar solicitudes a datos de blobs. Con Microsoft Entra ID, puede usar el control de acceso basado en rol de Azure (RBAC de Azure) para conceder permisos a una entidad de seguridad. La entidad de seguridad puede ser un usuario, un grupo, una entidad de servicio de aplicación o una identidad administrada de Azure. La entidad de seguridad se autentica mediante Microsoft Entra ID para devolver un token de OAuth 2.0. Después, el token se puede usar para autorizar una solicitud en Blob service.

Para más información sobre la autorización mediante Microsoft Entra ID, consulte Autorización del acceso a blobs mediante Microsoft Entra ID.

Permisos

A continuación se muestra la acción de RBAC necesaria para que un usuario, grupo, identidad administrada o entidad de servicio Microsoft Entra llame a la Delete Blob operación y el rol RBAC integrado con privilegios mínimos que incluya esta acción:

Para más información sobre cómo asignar roles mediante RBAC de Azure, consulte Asignación de un rol de Azure para el acceso a datos de blobs.

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 se agote el tiempo de espera de la Delete Blob operación. Si esto sucede, el cliente debe reintentar la solicitud.

Para la versión 2013-08-15 y posteriores, el cliente puede llamar Delete Blob a para eliminar blobs no confirmados. Un blob no confirmado es un blob creado con llamadas a la operación Put Block , pero que nunca se confirma 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 y ya no es accesible para los clientes.

Característica de eliminación temporal habilitada

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

Después del número de días especificado, los datos del blob se quitan del servicio. Para acceder a un blob o una instantánea eliminados temporalmente, llame a la operación Enumerar blobs y especifique la include=deleted opción .

Puede restaurar blobs o instantáneas eliminados temporalmente mediante Undelete Blob. Para cualquier otra operación en blobs o instantáneas eliminados temporalmente, Blob Storage devuelve el error 404 (recurso no encontrado).

Eliminar permanentemente

Con la versión 2020-02-10 y posteriores, puede eliminar permanentemente una instantánea o versión eliminada temporalmente. Para ello, habilite la característica. Para más información, consulte Establecimiento de propiedades de Blob Storage.

Nota

La cuenta de almacenamiento debe tener habilitado el control de versiones o las instantáneas. La eliminación temporal también debe estar habilitada en la cuenta de almacenamiento para eliminar temporalmente versiones o instantáneas de blobs en la cuenta. La eliminación permanente solo elimina instantáneas o versiones eliminadas temporalmente.

Las cuentas de almacenamiento con eliminación permanente habilitada pueden usar el deletetype=permanent parámetro de consulta para eliminar permanentemente una instantánea eliminada temporalmente o una versión de blob eliminada.

Si el parámetro de consulta presenta cualquiera de los siguientes elementos, Blob Storage devuelve un error 409 (Conflicto):

  • La característica de eliminación permanente no está habilitada para la cuenta de almacenamiento.
  • Ni 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 permiso de firma de acceso compartido para eliminar permanentemente una instantánea de blob o una versión de blob. Para más información, consulte Create una SAS de servicio.

Facturación

Las cuentas de almacenamiento no se cobran por Delete Blob las solicitudes.

Consulte también

Autorización de solicitudes a Azure Storage

Estado y códigos de error

Códigos de error de Blob Storage

Undelete Blob

Enumeración de blobs