Establecer etiquetas de blobs

  • Artículo
  • Tiempo de lectura: 5 minutos

La Set Blob Tags operación establece etiquetas definidas por el usuario para el blob especificado como uno o varios pares clave-valor.

Solicitud

La solicitud Set Blob Tags 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=tags

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

Parámetros de identificador URI

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

Parámetro Descripción
versionid Opcional para las versiones 2019-12-12 y posteriores. El parámetro versionid es un valor opaco que, cuando está presente, especifica la versión del blob que se DateTime va a recuperar.
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

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 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.
Content-Length Obligatorio. La longitud del contenido de la solicitud, en bytes. Tenga en cuenta que este encabezado hace referencia a la longitud del contenido del documento de etiquetas, no del propio blob.
Content-Type Obligatorio. El valor de este encabezado debe ser application/xml; charset=UTF-8.
Content-MD5 Opcional. Hash MD5 del contenido de la solicitud. Este hash se utiliza para comprobar la integridad del contenido de la solicitud durante el transporte. Si ambos valores de hash no coinciden, la operación producirá un error con el código de estado 400 (Solicitud incorrecta).

Tenga en cuenta que este encabezado está asociado al contenido de la solicitud, no al contenido del blob en sí.
x-ms-content-crc64 Opcional. Hash CRC64 del contenido de la solicitud. Este hash se utiliza para comprobar la integridad del contenido de la solicitud durante el transporte. Si ambos valores de hash no coinciden, la operación producirá un error con el código de estado 400 (Solicitud incorrecta).

Tenga en cuenta que este encabezado está asociado al contenido de la solicitud, no al contenido del blob en sí.

Si los encabezados y están presentes, se producirá un error en la solicitud con el Content-MD5 x-ms-content-crc64 código de error 400 (solicitud no correcta).
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-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 admite el x-ms-if-tags encabezado condicional para establecer etiquetas de 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

El formato del cuerpo de la solicitud es el siguiente:

<?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 la solicitud debe ser un documento XML UTF-8 bien formado que contenga un conjunto de etiquetas que represente las etiquetas del blob.

El conjunto de etiquetas puede contener como máximo 10 etiquetas. Los valores y las claves de etiqueta distinguen mayúsculas de minúsculas. Las claves de etiqueta deben tener entre 1 y 128 caracteres y los valores de etiqueta deben tener entre 0 y 256 caracteres. Entre los caracteres válidos de clave y valor de etiqueta se incluyen:

  • Letras minúsculas y mayúsculas (a-z, A-Z)
  • Dígitos (0-9)
  • Un espacio ( )
  • Más (+), menos (-), punto (.), solidus (/), dos puntos (:), igual a (=) y carácter de subrayado (_)

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 204 (Sin contenido).

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.
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.

Autorización

El propietario de la cuenta y cualquier persona con una firma de acceso compartido que tenga permiso para las etiquetas del blob (el permiso SAS) pueden llamar a esta t operación.

Además, los usuarios de RBAC con el permiso Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write pueden realizar esta operación.

Comentarios

La Set Blob Tags operación se admite en la API REST versión 2019-12-12 y posteriores.

La Set Blob Tags operación sobrescribe todas las etiquetas existentes en el blob. Para quitar todas las etiquetas de un blob, envíe una Set Blob Tags solicitud con un <TagSet> vacío.

Esta operación no actualiza la ETag ni la hora de la última modificación del blob. Es posible establecer etiquetas en un blob archivado.

El servicio de almacenamiento mantiene una fuerte coherencia entre un blob y sus etiquetas. Los cambios en las etiquetas de blob son inmediatamente visibles para las Get Blob Tags operaciones posteriores en el blob. Sin embargo, el índice secundario es coherente; Es posible que los cambios en las etiquetas de un blob no sean visibles inmediatamente para las Find Blobs by Tags operaciones.

Si una solicitud proporciona etiquetas no válidas, Blob service código de estado 400 (solicitud no válida).

Consulte también

Administración y búsqueda de datos en Azure Blob Storage con el Índice de blobs
Autorización de solicitudes para Azure Storage
Códigos de estado y error
Códigos de error del servicio BLOB