Establecimiento y recuperación de propiedades y metadatos para recursos de Blob Service

  • Artículo

Los contenedores y los blobs admiten metadatos personalizados, representados como encabezados HTTP. Los encabezados de metadatos se pueden establecer en una solicitud que crea un nuevo recurso de contenedor o de blob, o en una solicitud que crea explícitamente una propiedad en un recurso existente.

Este tema contiene los temas secundarios siguientes:

Formato de encabezado de metadatos

Operaciones en metadatos

Propiedades HTTP estándar para contenedores y blobs

Los blobs también admiten etiquetas, un tipo especial de metadatos personalizados que el servicio Blob indexa automáticamente. Para más información, consulte Administración y búsqueda de datos en Azure Blob Storage con el índice de blobs.

Formato de los encabezados de metadatos

Los encabezados de metadatos son pares nombre-valor. El formato del encabezado es:

x-ms-meta-name:string-value

A partir de la versión 2009-09-19, los nombres de metadatos deben cumplir las reglas de nomenclatura para los identificadores de C#.

Los nombres no distinguen mayúsculas de minúsculas. Tenga en cuenta que los nombres de los metadatos conservan las mayúsculas y minúsculas iniciales, pero no distinguen entre mayúsculas y minúsculas cuando se establecen o se leen. Si se envían dos o más encabezados de metadatos con el mismo nombre para un recurso, el servicio Blob devuelve el código de estado 400 (Solicitud incorrecta).

Los metadatos constan de pares nombre-valor. El tamaño total de todos los pares de metadatos puede ser de hasta 8 KB.

Los pares nombre-valor de metadatos son encabezados HTTP válidos y, como tales, deben cumplir todas las restricciones que regulan el uso de los encabezados HTTP.

Operaciones con metadatos

Los metadatos de un recurso de blob o de un recurso contenedor se pueden recuperar o establecer directamente, sin devolver ni modificar el contenido del recurso.

Tenga en cuenta que los valores de metadatos solo se pueden leer o escribir en su totalidad; no se admiten actualizaciones parciales. Cuando se establecen los metadatos de un recurso, se sobrescriben los valores de metadatos existentes para dicho recurso.

Recuperar propiedades y metadatos

Las operaciones GET y HEAD recuperan los encabezados de metadatos para el contenedor o el blob especificado. La operación HEAD solo devuelve encabezados; no devuelve un cuerpo de respuesta.

La sintaxis del URI para recuperar los encabezados de metadatos de un contenedor es la siguiente:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container

La sintaxis del URI para recuperar los encabezados de metadatos de un blob es la siguiente:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

Establecer encabezados de metadatos

La operación PUT establece los encabezados de metadatos del contenedor o blob especificado, sobrescribiendo los metadatos existentes en el recurso. Cuando se llama a PUT sin incluir encabezados en la solicitud, se borran todos los metadatos existentes en el recurso.

La sintaxis del URI para establecer los encabezados de metadatos de un contenedor es la siguiente:

PUT https://myaccount.blob.core.windows.net/mycontainer?comp=metadata?restype=container

La sintaxis del URI para establecer los encabezados de metadatos de un blob es la siguiente:

PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

Propiedades HTTP estándar para contenedores y blobs

Los contenedores y los blobs también admiten determinadas propiedades HTTP estándar. Las propiedades y los metadatos se representan como encabezados HTTP estándar; la diferencia entre ellos está en el nombre de los encabezados. Los nombres de los encabezados de metadatos están formados por el prefijo de encabezado x-ms-meta- y un nombre personalizado. Los encabezados de propiedad usan nombres de encabezado HTTP estándar, como se especifica en la sección 14 de definiciones de campo de encabezado de la especificación del protocolo HTTP/1.1.

Los encabezados HTTP estándar admitidos en los contenedores son los siguientes:

  • ETag

  • Last-Modified

Los encabezados HTTP estándar admitidos en los contenedores son los blobs:

  • ETag

  • Last-Modified

  • Content-Length

  • Content-Type

  • Content-MD5

  • Content-Encoding

  • Content-Language

  • Cache-Control

  • Origin

  • Range

Consulte también

Creación de un contenedor
Get Container Properties
Establecimiento de metadatos de contenedor
Put Blob
Copy Blob
Get Blob Properties
Get Blob Metadata
Set Blob Metadata
Conceptos de Blob Service
Administración y búsqueda de datos en Azure Blob Storage con el Índice de blobs