VENTAS: 1-800-867-1389

Set Container Metadata

Actualizado: febrero de 2015

La operación Set Container Metadata establece uno o varios pares nombre-valor definidos por el usuario para el contenedor especificado.

La solicitud Set Container Metadata se puede construir como sigue. Se recomienda HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento:

 

Método URI de solicitud Versión de HTTP

PUT

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

HTTP/1.1

Al realizar una solicitud en el servicio de almacenamiento emulado, especifique el nombre de host del emulador y el puerto del servicio Blob como 127.0.0.1:10000, seguido del nombre de la cuenta de almacenamiento emulado:

 

Método URI de solicitud Versión de HTTP

PUT

http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=metadata

HTTP/1.1

Para obtener más información, vea Uso del emulador de almacenamiento de Azure para desarrollo y prueba.

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

 

Parámetro Descripción

timeout

Opcional. El parámetro timeout se expresa en segundos. Para obtener más información, vea Establecer los tiempos de espera para las operaciones del servicio Blob.

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

 

Encabezado de solicitud Descripción

Authorization

Requerido. Especifica el esquema de autenticación, el nombre de la cuenta y la firma. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

Date o x-ms-date

Requerido. Especifica la hora universal coordinada (UTC) para la solicitud. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

x-ms-version

Obligatorio para todas las solicitudes autenticadas. Especifica la versión de la operación que se utiliza para esta solicitud. Para obtener más información, vea Versiones de los servicios Blob, Cola y Tabla de Windows Azure.

x-ms-lease-id: <ID>

Opcional, versión 2012-02-12 y versiones más recientes. Si se especifica, Set Container Metadata solo se realiza correctamente si la concesión del contenedor está activa y coincide con este identificador. Si no hay ninguna concesión activa o el identificador no coincide, se devuelve el código 412 (Error de condición previa).

x-ms-meta-name:value

Opcional. Par nombre-valor que se va a asociar con el contenedor como metadatos.

Cada llamada a esta operación reemplaza todos los metadatos existentes adjuntados al contenedor. Para quitar todos los metadatos del contenedor, llame a esta operación sin encabezados de metadatos.

Tenga en cuenta que, a partir de la versión 2009-09-19, los nombres de los metadatos deben cumplir las reglas de nomenclatura para los Identificadores de C#.

x-ms-client-request-id

Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 KB que se graba en los registros de análisis cuando el registro de análisis de almacenamiento está habilitado. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor. Para obtener más información, vea Acerca del registro del análisis de almacenamiento y Registro de Azure: usar registros para realizar el seguimiento de las solicitudes de almacenamiento.

Esta operación también admite el uso de encabezados condicionales que permiten establecer los metadatos del contenedor solo si se cumple una condición especificada. Para obtener más información, vea Definición de encabezados condicionales para las operaciones del servicio BLOB.

Request Syntax:
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=metadata HTTP/1.1

Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT
x-ms-meta-Category: Images
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Una operación correcta devuelve el código de estado 200 (Correcto).

Para obtener información acerca de los códigos de estado, vea Códigos de estado y de error.

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 cumplen la especificación del protocolo HTTP/1.1.

 

Encabezado de respuesta Descripción

ETag

La ETag del contenedor. Si la versión de la solicitud es 2011-08-18 o una más reciente, el valor ETag estará entre comillas.

Last-Modified

Devuelve la fecha y hora en que se modificó por última vez el contenedor. El formato de la fecha sigue las convenciones de RFC 1123. Para obtener más información, vea Representación de valores de fecha u hora en encabezados.

Cualquier operación que modifique el contenedor o sus propiedades o metadatos actualiza la hora de la última modificación, incluido el establecimiento de los permisos del contenedor. Las operaciones sobre blobs no afectan a la hora de la última modificación del contenedor.

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 obtener más información, vea Solucionar problemas relacionados con las operaciones de la API.

x-ms-version

Indica la versión del servicio Blob utilizado para ejecutar la solicitud. Este encabezado se devuelve para las solicitudes realizadas en la versión 2009-09-19 y versiones posteriores.

Date

Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta.

Access-Control-Allow-Origin

Se devuelve si la solicitud incluye un encabezado Origin y se ha habilitado CORS con una regla de coincidencia. Este encabezado devuelve el valor del encabezado Origin de la solicitud en caso de que haya una coincidencia.

Access-Control-Expose-Headers

Se devuelve si la solicitud incluye un encabezado Origin y se ha habilitado CORS con una regla de coincidencia. Devuelve la lista de encabezados de respuesta que se van a exponer al cliente o el emisor de la solicitud.

Access-Control-Allow-Credentials

Se devuelve si la solicitud incluye un encabezado Origin y se ha habilitado CORS con una regla de coincidencia que no permite todos los orígenes. Este encabezado se establecerá en true.

Solo el propietario puede llamar a esta operación.

La llamada a la operación Set Container Metadata sobrescribe todos los metadatos existentes asociados al contenedor. No es posible modificar un par nombre-valor individual.

También es posible establecer los metadatos de un contenedor en el momento en que se crea este.

La llamada a la operación Set Container Metadata actualiza las propiedades ETag y Last-Modified-Time del contenedor. Si la solicitud se realizó utilizando la versión 2011-08-18, la propiedad ETag actualizada estará entre comillas.

¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios
Mostrar:
© 2015 Microsoft