Exportar (0) Imprimir
Expandir todo

Establecer y recuperar propiedades y metadatos para los recursos de blob

Actualizado: noviembre de 2013

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 los encabezados de metadatos

Operaciones con metadatos

Propiedades HTTP estándar para contenedores y blobs

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 los metadatos deben cumplir las reglas de nomenclatura de los Identificadores de C#.

Los nombres no distinguen entre mayúsculas y 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).

El tamaño total de los metadatos, incluidos el nombre y el valor, no puede superar los 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.

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.

Las operaciones GET y HEAD recuperan los encabezados de metadatos para el contenedor o el blob especificado. Estas operaciones devuelven solo los encabezados; no devuelven ningún 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

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

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 nombres de propiedades utilizan nombres de encabezado HTTP estándar, según se especifica en la sección 14, que trata sobre definiciones de campos 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

Vea también

Mostrar:
© 2014 Microsoft