Obtener etiquetas de blobs

La Get Blob Tags operación devuelve todas las etiquetas definidas por el usuario para el blob, versión o instantánea especificados.

Solicitud

Puede construir la solicitud Get Blob Tags de la siguiente manera. Se recomienda usar HTTPS. Sustituye myaccount por el nombre de tu cuenta de almacenamiento:

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

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

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

Parámetros de URI

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

Parámetro Descripción
snapshot Opcional. El parámetro snapshot es un valor opaco DateTime que, cuando está presente, especifica la instantánea de blob que se va a recuperar. Para obtener más información sobre cómo trabajar con instantáneas de blobs, consulte Creación de una instantánea de un blob.
versionid Opcional para la versión 2019-12-12 y posteriores. El versionid parámetro es un valor opaco DateTime que, cuando está presente, especifica la versión de la mancha que se debe recuperar.
timeout Opcional. El parámetro timeout se expresa en segundos. Para más información, véase Establecer tiempos de espera para operaciones de almacenamiento en blobs.

Encabezados de solicitud

Los encabezados de solicitud obligatorios y opcionales se describen en la tabla siguiente:

Cabecera de solicitud Descripción
Authorization Obligatorio. Especifica el esquema de autorización, el nombre de la cuenta y la firma. Para más información, consulte Autorizar solicitudes a Azure Storage.
Date o x-ms-date Obligatorio. Especifica la hora universal coordinada (UTC) de la solicitud. Para más información, consulte Autorizar solicitudes a Azure Storage.
x-ms-version Necesario para todas las solicitudes autorizadas. Opcional para solicitudes anónimas. Especifica la versión de la operación que se va a usar para esta solicitud. Para más información, consulte Control de versiones de para 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 para este encabezado. Si no se especifica un ID válido de arrendamiento en la solicitud, la operación falla con el código de estado 403 (Prohibido).
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 más información, consulte Monitor Azure Blob Storage.

Esta operación permite que el x-ms-if-tags encabezado condicional obtenga etiquetas blob solo si se cumple una condición especificada. Para obtener más información, consulte Especificar encabezados condicionales para las operaciones de Blob Storage.

Cuerpo de la solicitud

Ninguno.

Respuesta

La respuesta incluye un código de estado HTTP, cabeceras de respuesta y un cuerpo 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 de esta operación incluye los siguientes encabezados. La respuesta también puede incluir encabezados HTTP estándar adicionales. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1 de .

Encabezado de respuesta Descripción
Content-Type application/xml
Content-Length El tamaño del documento XML devuelto, en bytes
x-ms-request-id Identifica de forma única la solicitud que se realizó y puede usarla para solucionar problemas de la solicitud. Para obtener más información, consulte Solución de problemas de operaciones de API.
x-ms-version Indica la versión de Blob Storage que se usa para ejecutar la solicitud.
Date Valor de fecha y hora UTC generado por el servicio, que indica la hora en que se inició la respuesta.
x-ms-client-request-id Se puede usar para solucionar problemas de solicitudes y sus respuestas correspondientes. El valor de esta cabecera es igual al valor de la x-ms-client-request-id cabecera si está presente en la petición y el valor no supera 1.024 caracteres ASCII visibles. Si el encabezado x-ms-client-request-id no está presente en la solicitud, este encabezado no está presente en la respuesta.

Cuerpo de respuesta

Aquí está el formato del cuerpo de respuesta:

<?xml version="1.0" encoding="utf-8"?>  
<Tags>  
    <TagSet>  
        <Tag>  
            <Key>tag-name-1</Key>  
            <Value>tag-value-1</Value>  
        </Tag>  
        <Tag>  
            <Key>tag-name-2</Key>  
            <Value>tag-value-2</Value>  
        </Tag>  
    </TagSet>  
</Tags>

El cuerpo de respuesta es un documento XML UTF-8 bien formado que representa todas las etiquetas almacenadas en el blob.

Authorization

Se requiere autorización al llamar a cualquier operación de acceso a datos en Azure Storage. Puede autorizar la operación de Get Blob Tags como se describe a continuación.

Importante

Microsoft recomienda usar el identificador de Entra de Microsoft con identidades administradas para autorizar solicitudes a Azure Storage. Microsoft Entra ID proporciona seguridad y facilidad de uso superiores 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. Microsoft Entra ID autentica la entidad de seguridad para devolver un token de OAuth 2.0. Después, el token se puede usar para autorizar una solicitud en Blob service.

Para obtener más información sobre la autorización mediante el identificador de Entra de Microsoft, consulte Autorizar el acceso a blobs mediante el identificador de Microsoft Entra.

Permisos

A continuación se enumeran las acciones de RBAC necesarias para que un usuario, grupo, identidad administrada o entidad de servicio de Microsoft Entra llame a la operación de Get Blob Tags y el rol RBAC integrado con privilegios mínimos que incluye esta acción:

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

Observaciones

La Get Blob Tags operación está soportada en la versión de la API REST 2019-12-12 y posteriores.

Para cuentas con espacio de nombres jerárquico activado, la Get Blob Tags operación es compatible con la versión 2024-11-04 x-ms y posteriores.

Nota: Las etiquetas blob para cuentas habilitadas con espacios de nombres jerárquicos están en vista previa pública y son accesibles mediante la Microsoft.Storage/BlobIndexForHns bandera AFEC. Para más información, consulte Configuración de características en versión preliminar en la suscripción de Azure.

El orden de las etiquetas no está garantizado en la respuesta.

El servicio de almacenamiento mantiene una coherencia fuerte entre un blob y sus etiquetas, pero el índice secundario es finalmente coherente. Las etiquetas pueden ser visibles en respuesta Get Blob Tags antes de que las Find Blobs by Tags operaciones.

Facturación

Las solicitudes de precios pueden originarse en clientes que usan api de Blob Storage, ya sea directamente a través de la API REST de Blob Storage o desde una biblioteca cliente de Azure Storage. Estas solicitudes acumulan cargos por transacción. El tipo de transacción afecta a cómo se cobra la cuenta. Por ejemplo, las transacciones de lectura se acumulan en una categoría de facturación diferente a las transacciones de escritura. En la tabla siguiente se muestra la categoría de facturación de las solicitudes de Get Blob Tags en función del tipo de cuenta de almacenamiento:

Operación Tipo de cuenta de almacenamiento Categoría de facturación
Obtener etiquetas de blobs Blob en bloques Premium
Estándar de propósito general v2		 Otras operaciones
Obtener etiquetas de blobs Uso general estándar v1 Operaciones de lectura

Para obtener información sobre los precios de la categoría de facturación especificada, consulte precios de Azure Blob Storage.

Consulte también

Gestionar y encontrar datos en Azure Blob Storage con Blob Index
Autorizar solicitudes a Azure Storage
códigos de error y estado
códigos de error de Blob Storage

  • Last updated on