Экспорт (0) Печать
Развернуть все

Получение диапазонов страниц

Обновлено: Январь 2014 г.

Операция Get Page Ranges возвращает список допустимых диапазонов страниц для страничного большого двоичного объекта или для моментального снимка такого объекта.

Запрос Get Page Ranges можно составить следующим образом. Рекомендуется использовать протокол HTTPS. Замените myaccount именем нужной учетной записи хранения.

 

  URI запроса метода GET Версия 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

При построении запроса к эмулированной службе хранилища укажите имя узла эмулятора и порт службы BLOB-объектов как 127.0.0.1:10000, затем укажите имя эмулированной учетной записи хранилища.

 

  URI запроса метода GET Версия HTTP

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

HTTP/1.1

Дополнительные сведения см. в Использование эмулятора хранилища Azure для разработки и тестирования.

В URI запроса могут быть заданы следующие дополнительные параметры.

 

Параметр Описание

snapshot

Необязательно. Параметр моментального снимка является непрозрачным значением DateTime, которое при наличии задает большой двоичный объект, из которого следует получить информацию. Дополнительные сведения о работе с моментальными снимками BLOB-объектов см. в разделе Создание моментальных снимков больших двоичных объектов.

timeout

Необязательно. Параметр timeout указывается в секундах. Дополнительные сведения см. в Задание времени ожидания для операций службы BLOB-объектов.

В следующей таблице перечислены обязательные и необязательные заголовки запросов.

 

Заголовок запроса Описание

Authorization

Обязательно. Указывает схему проверки подлинности, имя учетной записи и подпись. Дополнительные сведения см. в Проверка подлинности для служб хранения Azure.

Date или x-ms-date

Обязательно. Задает время в формате UTC для запроса. Дополнительные сведения см. в Проверка подлинности для служб хранения Azure.

x-ms-version

Обязательно для всех запросов с проверкой подлинности, необязательно для анонимных запросов. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в Управление версиями для служб хранилища Azure.

Range

Необязательно. Указывает диапазон байтов, по которому следует перечислять диапазоны, включительно. Если параметр пропущен, то возвращаются все диапазоны для большого двоичного объекта.

x-ms-range

Необязательно. Указывает диапазон байтов, по которому следует перечислять диапазоны, включительно.

Если заданы оба параметра, Range и x-ms-range, то служба использует значение x-ms-range. Дополнительные сведения см. в разделе Указание заголовка диапазона для операций службы BLOB-объектов.

x-ms-lease-id:<ID>

Необязательно. Если этот заголовок указан, то операция будет выполнена, только если выполняются оба следующих условия.

  • Аренда BLOB-объекта в настоящее время активна.

  • Идентификатор аренды, указанный в запросе, соответствует данному идентификатору у BLOB-объекта.

Если этот заголовок указан и оба эти условия не выполнены, попытка выполнения запроса окончится неудачей и операция завершится ошибкой с кодом состояния 412 (не выполнено предварительное условие).

x-ms-client-request-id

Необязательно. Предоставляет сформированное клиентом непрозрачное значение с ограничением в 1 КБ, которое записывается в журналы аналитики, когда включено ведение журналов аналитики хранилища. Этот заголовок настоятельно рекомендуется использовать для соотнесения действий, выполняемых на стороне клиента, с запросами, получаемыми сервером. Дополнительные сведения см. в разделах Сведения о ведении журнала службы аналитики хранилища и Ведение журналов в Windows Azure: использование журналов для отслеживания запросов к хранилищу.

Эта операция также поддерживает использование условных заголовков для получения диапазонов страниц только при выполнении условия. Дополнительные сведения см. в Указание условных заголовков для операций со службой BLOB-объектов.

Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.

Успешная операция возвращает код состояния 200 (ОК).

Сведения о кодах состояния см. в разделе Коды состояний и ошибок.

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют Спецификации протокола HTTP/1.1.

 

Синтаксис Описание

Last-Modified

Дата и время последнего изменения BLOB-объекта. Дата в формате согласно RFC 1123.

Любая операция, которая изменяет большой двоичный объект, в том числе обновление метаданных или свойств большого двоичного объекта, меняет время последнего изменения этого объекта.

ETag

ETag содержит значение, которое клиент может использовать для условного выполнения операции. Если версия запроса 2011-08-18 или более поздняя, то значение ETag будет указано в кавычках.

x-ms-blob-content-length

Размер большого двоичного объекта в байтах.

x-ms-request-id

Этот заголовок однозначно определяет выполненный запрос, его также можно использовать для устранения связанных с запросом неполадок. Дополнительные сведения см. в Устранение неполадок при API-операциях.

x-ms-version

Указывает версию службы BLOB-объектов, используемую для выполнения запроса. Этот заголовок возвращается для запросов к версии 2009-09-19 и более поздним версиям.

Этот заголовок также возвращается для анонимных запросов без указания версии, если контейнер был помечен как доступный для общего доступа с помощью версии 2009-09-19 службы BLOB-объектов.

Date

Значение даты и времени в формате UTC, сформированное службой и указывающее время, когда был инициирован ответ.

Текст ответа включает список неперекрывающихся допустимых диапазонов страниц, отсортированный в порядке роста диапазонов адресов страниц. Текст ответа имеет следующий формат.

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

Если весь набор страниц большого двоичного объекта был очищен, то текст ответа не будет содержать диапазонов страниц.

Эта операция может быть выполнена как владельцем учетной записи, так и кем угодно с использованием подписи общего доступа с разрешением на чтение BLOB-объектов. Если в списке управления доступом контейнера разрешен анонимный доступ, то вызвать эту операцию может любой клиент.

Смещения начального и конечного байтов для каждого из диапазонов страниц рассматриваются, как включающие.

В значительно фрагментированном страничном большом двоичном объекте с большим количеством записей запрос Get Page Ranges может завершиться ошибкой в связи с истечением внутреннего времени ожидания на сервере. Приложения, получающие диапазоны страничного большого двоичного объекта со значительным числом операций записи, должны извлекать за раз подмножество диапазонов страниц. Дополнительные сведения см. в разделе Получение диапазонов страниц крупных страничных больших двоичных объектов по сегментам.

Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2014 Microsoft