Delete Blob

Artículo
02/03/2024

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:

Acción de RBAC de Azure:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/delete
Rol integrado con privilegios mínimos:Colaborador de datos de Storage Blob

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.

Una firma de acceso compartido (SAS) proporciona acceso delegado seguro a los recursos de una cuenta de almacenamiento. Con una SAS, tiene un control pormenorizado sobre cómo un cliente puede acceder a los datos. Puede especificar a qué recurso puede acceder el cliente, qué permisos tienen para esos recursos y cuánto tiempo es válido la SAS.

La Delete Blob operación admite tres tipos de firmas de acceso compartido: SAS de delegación de usuarios, SAS de servicio y SAS de cuenta.

Como procedimiento recomendado de seguridad, se recomienda usar Microsoft Entra credenciales en lugar de la clave de la cuenta de almacenamiento, que se puede poner en peligro más fácilmente. Si el diseño de la aplicación requiere firmas de acceso compartido, use Microsoft Entra credenciales para crear una SAS de delegación de usuarios, siempre que sea posible.

Cuando no se permite el acceso a la clave compartida para la cuenta de almacenamiento, no se permitirá un token de SAS de servicio o un token de SAS de cuenta en una solicitud a Blob Storage. Para más información, consulte Descripción de cómo no permitir la clave compartida afecta a los tokens de SAS.

SAS de delegación de usuarios

Una SAS de delegación de usuarios está protegida con credenciales de Microsoft Entra y también por los permisos especificados para la SAS.

La llamada a la Delete Blob operación mediante un token de SAS delegado en un recurso de contenedor o blob requiere el permiso Delete (d) como parte del token de SAS de delegación de usuarios.

Para más información sobre la SAS de delegación de usuarios, consulte Create una SAS de delegación de usuarios.

SAS de servicio

Una SAS de servicio está protegida con la clave de cuenta de almacenamiento. Una SAS de servicio delega el acceso a un recurso en un único servicio de Azure Storage, como Blob Storage.

La llamada a la Delete Blob operación mediante un token de SAS delegado en un recurso de contenedor o blob requiere el permiso Delete (d) como parte del token de SAS de servicio.

Para más información sobre la SAS de servicio, consulte Create una SAS de servicio.

SAS de cuenta

Una SAS de cuenta está protegida con la clave de cuenta de almacenamiento. SAS de cuenta delega el acceso a los recursos en uno o varios de los servicios de almacenamiento. Todas las operaciones disponibles con una SAS de servicio o delegación de usuarios están también disponibles con una SAS de cuenta.

En la tabla siguiente se indica el tipo de recurso firmado y los permisos firmados que se especificarán al delegar el acceso:

Operación	Servicio firmado	Tipo de recurso firmado	Permiso firmado
Delete Blob	Blob (b)	Objeto (o)	Eliminar (d)

Para más información sobre la SAS de cuenta, consulte Create una SAS de cuenta.

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.