VENTAS: 1-800-867-1389
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

Get Page Ranges

 

La Get Page Ranges operación devuelve la lista de intervalos de páginas válidos para un blob de página o una instantánea de un blob de página.

El Get Page Ranges solicitud se puede generar como sigue. Se recomienda HTTPS. Reemplace myaccount con el nombre de la cuenta de almacenamiento:

URI de solicitud del método GET

Versión de HTTP

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

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=pagelist&snapshot=<DateTime>

HTTP/1.1

Al realizar una solicitud al 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 GET

Versión de HTTP

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

HTTP/1.1

Para obtener más información, vea mediante el emulador de almacenamiento de Azure para desarrollo y pruebas.

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

Parámetro

Descripción

snapshot

Opcional. El parámetro de instantánea es opaco DateTime valor que, cuando está presente, especifica para recuperar información de la instantánea de blob. Para obtener más información sobre cómo trabajar con instantáneas de blob, vea Crear una instantánea de un Blob.

timeout

Opcional. La propiedad SIDHistory hace esto posible. 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 solicitudes 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, opcional para las solicitudes anónimas. 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 de almacenamiento de Azure.

Range

Opcional. Especifica el intervalo de bytes (incluidos) cuya lista de intervalos se va a obtener. Si se omite, se devuelven todos los intervalos del blob.

x-ms-range

Opcional. Especifica el intervalo de bytes (incluidos) cuya lista de intervalos se va a obtener.

Si ambos Range y x-ms-range se especifica, el servicio utiliza el valor de x-ms-range. Consulte Especificar el encabezado de intervalo para las operaciones de servicio de Blob para obtener más información.

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 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 registrado en los registros de análisis cuando está habilitado registro del análisis de almacenamiento. Es muy recomendable usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor. Para obtener más información, consulte Acerca del registro de análisis de almacenamiento y registro de Azure: Usar registros para seguir las solicitudes de almacenamiento.

Esta operación también admite el uso de encabezados condicionales para obtener intervalos de páginas solo si se cumple una condición especificada. Para obtener más información, vea Especificar encabezados condicionales para las operaciones de servicio de Blob.

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y el cuerpo 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 Estado y códigos 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 se ajustan a la especificación del protocolo HTTP/1.1.

Sintaxis

Descripción

Last-Modified

La fecha y la hora en la que se modificó por última vez el blob. El formato de la fecha sigue las convenciones de RFC 1123.

Cualquier operación que modifique el blob, incluida una actualización de los metadatos o las propiedades del blob, cambia la hora de la última modificación del blob.

ETag

La ETag contiene un valor que el cliente puede utilizar para realizar la operación condicional. Si la versión de la solicitud es 2011-08-18 o una más reciente, el valor ETag estará entre comillas.

x-ms-blob-content-length

El tamaño del blob en bytes.

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 Solución de problemas de las operaciones de 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.

Este encabezado también se devuelve para las solicitudes anónimas sin una versión especificada si el contenedor se marcó para acceso público utilizando la versión 2009-09-19 del servicio Blob.

Date

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

El cuerpo de respuesta incluye una lista de intervalos de páginas válidos que no se superponen, ordenada por intervalo de páginas de direcciones en orden ascendente. El formato del cuerpo de respuesta es el siguiente.

<?xml version="1.0" encoding="utf-8"?> <PageList> <PageRange> <Start>Start Byte</Start> <End>End Byte</End> </PageRange> <PageRange> <Start>Start Byte</Start> <End>End Byte</End> </PageRange> </PageList>

Si se ha borrado el conjunto completo de páginas del blob, el cuerpo de respuesta no incluirá ningún intervalo de páginas.

Esta operación la puede realizar el propietario de la cuenta o cualquiera que utilice una firma de acceso compartido con permiso para leer el blob. Si se ha establecido la ACL del contenedor para permitir el acceso anónimo, cualquier cliente puede llamar a esta operación.

Los desplazamientos de byte inicial y final de cada intervalo de páginas son inclusivos.

En un blob de páginas muy fragmentado con un gran número de operaciones de escritura, un Get Page Ranges solicitud puede producir un error debido a un tiempo de espera interno del servidor. Las aplicaciones que recuperan intervalos de un blob en páginas con un gran número de operaciones de escritura deben recuperar un subconjunto de intervalos de páginas cada vez. Para obtener más información, vea obtener los intervalos de páginas de un Blob de página grande en segmentos.

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