VENTAS: 1-800-867-1389

Snapshot Blob

Publicada: agosto de 2011

Actualizado: enero de 2014

La operación Snapshot Blob crea una instantánea de solo lectura de un blob.

La solicitud Snapshot Blob 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 de HTTP

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

HTTP/1.1

Cuando realice 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:

 

  URI de solicitud del método PUT Versión de HTTP

http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=snapshot

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 bien 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 Control de versiones de los servicios de almacenamiento de Azure.

x-ms-meta-name:value

Opcional. Especifica un par nombre-valor definido por el usuario asociado al blob. Si no se especifica ningún par nombre-valor, la operación copiará los metadatos del blob base en la instantánea. Si se especifican uno o varios pares nombre-valor, la instantánea se crea con los metadatos especificados, y los metadatos no se copian del blob base.

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#. Vea Asignar nombres y hacer referencia a contenedores, blobs y metadatos para obtener más información.

If-Modified-Since

Opcional. Valor DateTime. Especifique este encabezado condicional para crear una instantánea del blob solo si este se ha modificado desde la fecha u hora especificada. Si el blob base no se ha modificado, el servicio Blob devuelve el código de estado 412 (Error de condición previa).

If-Unmodified-Since

Opcional. Valor DateTime. Especifique este encabezado condicional para crear una instantánea del blob solo si este no se ha modificado desde la fecha u hora especificada. Si el blob base se ha modificado, el servicio Blob devuelve el código de estado 412 (Error de condición previa).

If-Match

Opcional. Valor ETag. Especifique un valor ETag para este encabezado condicional para crear una instantánea del blob solo si su valor ETag coincide con el valor especificado. Si los valores no coinciden, el servicio Blob devuelve el código de estado 412 (Error de condición previa).

If-None-Match

Opcional. Valor ETag.

Especifique un valor ETag para este encabezado condicional para crear una instantánea del blob solo si su valor ETag no coincide con el valor especificado. Si los valores son idénticos, el servicio Blob devuelve el código de estado 412 (Error de condición previa).

x-ms-lease-id:<ID>

Opcional. Si se especifica este encabezado, la operación se realizará solo si se cumplen las dos condiciones siguientes:

  • La concesión del blob está activa actualmente.

  • El identificador de concesión especificado en la solicitud coincide con el del blob.

Si se especifica este encabezado y no se cumplen ambas condiciones, la solicitud producirá un error y la operación Snapshot Blob generará un error con el código de estado 412 (Error de condición previa).

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 Windows 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 ejecutar la operación solo si se cumple una condición especificada. Para obtener más información, vea Especificar encabezados condicionales para las operaciones del servicio Blob.

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 201 (Creado).

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.

 

Sintaxis Descripción

x-ms-snapshot: <DateTime>

Este encabezado devuelve un valor DateTime que identifica de forma única la instantánea. El valor del encabezado indica la versión de la instantánea y se puede usar en las solicitudes posteriores para tener acceso a la instantánea. Tenga en cuenta que este valor es opaco.

ETag

La ETag de la instantánea. Si la versión de la solicitud es 2011-08-18 o una más reciente, el valor ETag estará entre comillas. Tenga en cuenta que no es posible escribir en una instantánea, por lo que su ETag no cambia nunca. Sin embargo, la ETag de la instantánea variará con respecto a la del blob base si en la solicitud Snaphot Blob se suministran nuevos metadatos. Si en la solicitud no se especifican metadatos, la ETag de la instantánea será idéntica a la del blob base en el momento en que se tomó la instantánea.

Last-Modified

La hora de la última modificación de la instantánea. 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.

Tenga en cuenta que no es posible escribir en una instantánea, por lo que la hora en que se modificó por última vez no cambia nunca. Sin embargo, la hora de la última modificación de la instantánea variará con respecto a la del blob base si en la solicitud Snaphot Blob se suministran nuevos metadatos. Si en la solicitud no se especifican metadatos, la hora de la última modificación de la instantánea será idéntica a la del blob base en el momento en que se tomó la instantánea.

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

Solo el propietario de la cuenta puede llamar a esta operación.

Las instantáneas proporcionan versiones de solo lectura de los blobs. Una vez que se ha creado una instantánea, se puede leer, copiar o eliminar, pero no se puede modificar.

Una instantánea constituye una manera cómoda de realizar copias de seguridad de los datos del blob. Puede utilizar una instantánea para restaurar un blob a una versión anterior llamando a Copy Blob para sobrescribir un blob base con su instantánea.

Cuando se crea una instantánea, el servicio Blob devuelve un valor DateTime que identifica de forma única la instantánea en relación con el blob base. Puede usar este valor para realizar otras operaciones en la instantánea. Tenga en cuenta que debe tratar el valor DateTime como opaco.

El valor DateTime identifica la instantánea en el URI. Por ejemplo, los URI de un blob base y de sus instantáneas se parecen a los siguientes:

  • Blob base: http://myaccount.blob.core.windows.net/mycontainer/myblob

  • Instantánea: http://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

Tenga en cuenta que cada vez que se llama la operación Snapshot Blob, se crea una nueva instantánea con un valor DateTime único. Un blob puede tener cualquier número de instantáneas. Las instantáneas existentes no se sobrescriben, pero se deben eliminar explícitamente llamando a Delete Blob y estableciendo el encabezado x-ms-include-snapshots en el valor adecuado.

Leer, copiar, y eliminar instantáneas

Una llamada correcta a Snapshot Blob devuelve un valor DateTime en el encabezado de respuesta x-ms-snapshot. Puede utilizar este valor DateTime para realizar operaciones de lectura, eliminación o copia en una determinada versión de la instantánea. Se puede llamar a cualquier operación del servicio Blob que sea válida para una instantánea especificando ?snapshot=<DateTime> después del nombre del blob.

Copiar las propiedades y los metadatos del blob

Cuando se crea una instantánea de un blob, se copian en ella las siguientes propiedades del sistema con los mismos valores:

  • Content-Type

  • Content-Encoding

  • Content-Language

  • Content-Length

  • Cache-Control

  • Content-MD5

  • x-ms-blob-sequence-number (for page blobs only)

  • x-ms-copy-id (versión 2012-02-12 y versiones más recientes)

  • x-ms-copy-status (versión 2012-02-12 y versiones más recientes)

  • x-ms-copy-source (versión 2012-02-12 y versiones más recientes)

  • x-ms-copy-progress (versión 2012-02-12 y versiones más recientes)

  • x-ms-copy-completion-time (versión 2012-02-12 y versiones más recientes)

  • x-ms-copy-status-description (versión 2012-02-12 y versiones más recientes)

La lista de bloques confirmados del blob base también se copia en la instantánea, si el blob es un blob en bloques. No se copiarán los bloques sin confirmar.

El blob de instantánea tiene siempre el mismo tamaño que el blob base en el momento en que se toma la instantánea, por lo que el valor del encabezado Content-Length del blob de instantánea es el mismo que el del blob base.

Puede especificar uno o varios valores de metadatos nuevos para la instantánea especificando el encabezado x-ms-meta-name:value en la solicitud. Si no se especifica este encabezado, los metadatos asociados al blob base se copian en la instantánea.

Especificar encabezados condicionales

Puede especificar encabezados condicionales en la solicitud para que se cree una instantánea del blob solo si se cumple una condición. Si la condición especificada no se cumple, la instantánea no se crea, y el servicio Blob devuelve el código de estado 412 (Error de condición previa) junto con información adicional sobre la condición que no se ha cumplido.

Crear una instantánea de un blob sujeto a una concesión

Si el blob base tiene una concesión activa, puede crear una instantánea del blob siempre y cuando la solicitud cumpla cualquiera de las condiciones siguientes:

  • Se ha especificado el encabezado condicional x-ms-lease-id y el identificador de la concesión activa para el blob base está incluido en la solicitud. Esta condición especifica que la instantánea se creará solo si la concesión está activa y el identificador de la concesión especificado coincide con el identificador asociado al blob.

  • El encabezado x-ms-lease-id no se ha especificado, en cuyo caso se omite la concesión de acceso de escritura exclusivo.

Tenga en cuenta que en la instantánea no se copia ninguna concesión asociada al blob base. Las instantáneas no se pueden conceder.

Copiar instantáneas

Cuando se copia un blob base con la operación Copy Blob, las instantáneas del blob base no se copian en el blob de destino. Cuando un blob de destino se sobrescribe con una copia, las instantáneas asociadas al blob de destino bajo su nombre no se modifican.

Para restaurar una versión anterior de un blob, puede copiar un blob de instantánea en su blob base. La instantánea se conserva, pero el blob base se sobrescribe con una copia que se puede leer y escribir.

noteNota
Promover una instantánea de esta manera no conlleva ningún cargo adicional de recursos de almacenamiento, ya que los bloques o las páginas se comparten entre la instantánea y el blob base.

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