Продажи: 1-800-867-1389

Получение данных из файла

Обновлено: Август 2015 г.

Операция Get File считывает или загружает файл из системы, включая метаданные и свойства.

Запрос Get File можно составить следующим образом. Рекомендуется использовать протокол HTTPS.

 

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

GET

https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile

HTTP/1.1

Замените компоненты пути, показанный в URI запроса, следующим образом:

 

Компонент пути Описание

myaccount

Имя учетной записи хранения.

myshare

Имя файлового ресурса.

mydirectorypath

Необязательно. Путь к каталогу.

myfile

Имя файла.

Сведения об ограничениях именах пути см. в разделе Именование общих ресурсов, каталогов, файлов и метаданных и ссылка на них.

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

 

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

timeout

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

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

 

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

Authorization

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

Date или x-ms-date

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

Range

Необязательно. Возвращает данные файла только из указанного диапазона байтов.

x-ms-range

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

x-ms-range-get-content-md5: true

Необязательно. Если этот заголовок имеет значение true и указан вместе с заголовком Range, то служба возвращает хэш MD5 для диапазона, пока диапазон меньше или равен 4 МБ.

Если этот заголовок указан без заголовка Range, то служба возвращает код состояния 400 (неверный запрос).

Если этот заголовок имеет значение true и диапазон превышает 4 МБ, то служба возвращает код состояния 400 (неверный запрос).

Отсутствует.

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

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

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

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

 

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

Last-Modified

Возвращает дату и время последнего изменения файла. Дата в формате согласно RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках. Любая операция, которая изменяет каталог или его свойства, обновляет время последнего изменения. Операции с файлами не влияют на время последнего изменения каталога.

x-ms-meta-name:value

Набор пары «имя-значение», связанной с этим файлом, в качестве определяемых пользователем метаданных.

Content-Length

Число байтов в тексте ответа.

Content-Type

Тип контента, указанный для файла. Тип содержимого по умолчанию — application/octet-stream.

Content-Range

Указывает диапазон байтов, возвращенных в случае, если клиент запросил подмножество файла путем указания заголовка запроса Range.

ETag

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

Content-MD5

Если файл имеет хэш MD5 и запрос должен прочитать весь файл, то возвращается этот заголовок ответа, чтобы клиент смог проверить целостность содержимого сообщения.

Если запрос должен прочитать указанный диапазон и параметр x-ms-range-get-content-md5 имеет значение "true", то запрос возвращает хэш MD5 для диапазона, если размер диапазона меньше или равен 4 МБ.

Если ни один из наборов условий не выполняется, то заголовок Content-MD5 не имеет значения.

Если x-ms-range-get-content-md5 указан без заголовка "Диапазон", то служба возвращает код состояния 400 (неверный запрос).

Если x-ms-range-get-content-md5 имеет значение true и диапазон превышает 4 МБ, то служба возвращает код состояния 400 (неверный запрос).

Content-Encoding

Заголовок возвращает значение, которое было указано для заголовка запроса Content-Encoding.

Content-Language

Заголовок возвращает значение, которое было указано для заголовка запроса Content-Language.

Cache-Control

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

Content-Disposition

Возвращает значение, указанное для заголовка x-ms-content-disposition, и указывает, как обработать ответ.

Поле заголовка ответа Content-Disposition предоставляет дополнительные сведения о том, как обрабатывать полезные данные ответа, а также может использоваться для присоединения дополнительных метаданных. Например, если задано значение attachment, то Content-Disposition указывает, что агент пользователя не покажет ответ, а выведет на экран диалоговое окно Сохранить как.

x-ms-request-id

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

x-ms-version

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

Accept-Ranges: bytes

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

Date

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

Текст ответа содержит содержимое файла.

Response Status:
HTTP/1.1 200 OK

Response Headers:
x-ms-type: File
x-ms-meta-m1: v1
x-ms-meta-m2: v2
Content-Length: 11
Content-Type: text/plain; charset=UTF-8
Date: Mon, 27 Jan 2014 22:49:18 GMT
ETag: "0x8CB171DBEAD6A6B"
Last-Modified: Mon, 27 Jan 2014 22:48:29 GMT
x-ms-version: 2014-02-14
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

Вызов этой операции доступен только владельцу учетной записи.

При вызове метода Get File для диапазона, который еще не имеет содержимого, или был очищен, возвращается нули для таких байтов.

При вызове метода Get File без указания диапазона служба возвращает диапазон байт не более значения, указанного в заголовке x-ms-content-length. Для всех диапазонов без содержимого служба возвращает нуль.

Операция Get File должна завершиться за 2 минуты на 1 МБ. Если операция в среднем занимает более 2 минут на мегабайт, время ее ожидания истечет.

Основные понятия

Операции с файлами

Была ли вам полезна эта информация?
(1500 символов осталось)
Спасибо за ваш отзыв
Показ:
© 2015 Microsoft