Получить BLOB-объект

Операция Get Blob читает или скачивает blob из системы, включая её метаданные и свойства. Вы также можете позвонить Get Blob , чтобы прочитать снимок.

Просьба

Можно создать запрос Get Blob следующим образом. Рекомендуется использовать ПРОТОКОЛ HTTPS. Замените myaccount на имя вашего аккаунта хранения:

URI запроса метода GET Версия HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob

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

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>

 HTTP/1.0

HTTP/1.1

URI службы эмулированного хранилища

Когда вы отправляете запрос к эмулируемому сервису хранения, укажите имя хоста эмулятора и порт Azure Blob Storage как 127.0.0.1:10000, а затем имя эмулируемой аккаунта хранения:

URI запроса метода GET Версия HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

HTTP/1.1

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

Параметры URI

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

Параметр Description
snapshot Необязательно. Параметр снимка — это непрозрачное DateTime значение, которое, когда оно присутствует, указывает снимок blob, который нужно получить для извлечения. Для получения дополнительной информации о работе с снимками blob см. раздел «Создать снимок blob».
versionid Необязательно, версия 2019-12-12 и более поздняя. Параметр — это непрозрачное versionid значение, которое, при наличииDateTime, указывает версию blob-а, которую нужно извлечь.
timeout Необязательно. Параметр timeout выражается в секундах. Для получения дополнительной информации см. раздел «Установка тайм-аутов для операций с Blob Storage».

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

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

Заголовок запроса Description
Authorization Обязательное. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
Date или x-ms-date Обязательное. Указывает универсальное время (UTC) для запроса. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
x-ms-version Требуется для всех авторизованных запросов. Необязательно для анонимных запросов. Указывает версию операции, используемой для этого запроса. Если этот заголовок отсутствует для анонимного запроса, сервис выполняет запрос с версией 2009-09-19. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
Range Необязательно. Возвращайте байты blob только в указанном диапазоне.
x-ms-range Необязательно. Возвращайте байты blob только в указанном диапазоне. Если указаны оба Range и x-ms-range , сервис использует значение x-ms-range. Если ни один из диапазонов не указан, возвращается весь содержимое blob. Для получения дополнительной информации см. Укажите заголовок диапазона для операций Blob Storage.
x-ms-lease-id: <ID> Необязательно. Если этот заголовок указан, операция выполняется только при выполнении обоих следующих условий:

- Аренда blob в настоящее время действует.
- Идентификатор аренды, указанный в запросе, совпадает с идентификатором лизинга blob.

Если этот заголовок указан, но ни одно из этих условий не выполнено, запрос не выполняется, и Get Blob операция заканчивается с кодом статуса 412 (предварительное условие невыполнено).
x-ms-range-get-content-md5: true Необязательно. Когда этот заголовок устанавливается и true указывается вместе с Range ним, сервис возвращает MD5-хэш для этого диапазона, при условии, что диапазон меньше или равен 4 мебибайтам (МиБ).

Если заголовок указан без заголовка Range , сервис возвращает статус 400 (Плохой запрос).

Если заголовок установлен так, true чтобы расстояние превышало 4 МиБ, сервис возвращает статус 400 (Плохой запрос).
x-ms-range-get-content-crc64: true Необязательно. Когда этот заголовок устанавливается и true указывается вместе с Range ним, сервис возвращает хэш CRC64 для этого диапазона, при условии, что диапазон меньше или равен 4 МиБ.

Если заголовок указан без заголовка Range , сервис возвращает статус 400 (Плохой запрос).

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

Если оба x-ms-range-get-content-md5x-ms-range-get-content-crc64 заголовка и присутствуют, запрос проваливается с 400 (плохой запрос).

Этот заголовок поддерживается в версиях 2019-02-02 и позднее.
Origin Необязательно. Указывает источник отправки запроса. Наличие этого заголовка приводит к появлению заголовков кросс-источникового совместного использования ресурсов (CORS) в ответе.
x-ms-upn Необязательно. Версия 2023-11-03 и выше. Валидно для аккаунтов с включённым иерархическим пространством имён. Если это верно, значения идентичности пользователя, возвращаемые в x-ms-ownerзаголовках , x-ms-group и x-ms-acl ответа, будут преобразованы из идентификаторов объектов Microsoft Entra в пользовательские принципальные имена. Если значение ложное, они возвращаются как идентификаторы объектов Microsoft Entra. Значение по умолчанию — false. Обратите внимание, что идентификаторы групповых и прикладных объектов не переводятся, потому что у них нет уникальных дружественных имён.
x-ms-client-request-id Необязательно. Предоставляет клиентские, непрозрачное значение с ограничением символа в 1 кибибайта (KiB), которое записывается в аналитические журналы при включении логирования аналитики хранилища. Мы настоятельно рекомендуем использовать этот заголовок при сопоставлении клиентских действий с запросами, полученными сервером. Для получения дополнительной информации смотрите раздел «О логировании Azure Storage Analytics».
x-ms-structured-body Необязательно. Версия 2025-01-05 и выше. Если указано, сервис вернёт содержимое blob, закодированное в структурированном формате тела. Значение этого заголовка содержит версию схемы сообщений и свойства.

В настоящее время единственное поддерживаемое значение — XSM/1.0; properties=crc64, указывающее, что ответ будет использовать сегменты контрольной суммы crc64 в закодированном сообщении. Если значение не совпадает с этим, операция заканчивается с кодом ошибки 400 (Плохой запрос).

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

Заголовки запросов (ключи шифрования, предоставляемые клиентом)

С версии 2019-02-02 вы можете указать следующие заголовки в запросе для чтения blob-а, зашифрованного ключом, предоставленным клиентом. Шифрование с ключом, предоставленным клиентом (и соответствующим набором заголовков) является необязательным. Если blob ранее был зашифрован ключом, предоставленным клиентом, необходимо указать эти заголовки в запросе для успешного завершения операции чтения.

Заголовок запроса Description
x-ms-encryption-key Обязательное. Ключ шифрования AES-256, закодированный по Base64.
x-ms-encryption-key-sha256 Необязательно. Хэш SHA256, закодированный в Base64, ключ шифрования.
x-ms-encryption-algorithm: AES256 Обязательное. Задаёт алгоритм для шифрования. Значение этого заголовка должно быть AES256.

Основное содержание запроса

Нет.

Ответ

Ответ включает HTTP-код статуса, набор заголовков ответа и тело ответа, содержащее содержимое blob-а.

Код состояния

Успешная операция чтения полного blob возвращает статус 200 (OK).

Успешная операция чтения заданного диапазона возвращает статус 206 (частичный контент).

Дополнительные сведения о кодах состояния см. в коды состояния и коды ошибок.

Заголовки ответа

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

Синтаксис Description
Last-Modified Дата/время последней модификации blob. Формат даты соответствует RFC 1123.

Любая операция, которая изменяет большой двоичный объект, включая обновление метаданных или свойств большого двоичного объекта, изменяет время последнего изменения большого двоичного объекта.
x-ms-creation-time Версия 2017-11-09 и выше. Дата/время, когда было создано пятно. Формат даты соответствует RFC 1123.
x-ms-meta-name:value Набор пар имя-значение, который ассоциируется с этим blob как пользовательские метаданные.
x-ms-tag-count Версия 2019-12-12 и позже. Если у blob есть какие-либо теги, этот заголовок возвращает количество тегов, хранящихся на блобе. Заголовок не возвращается, если на блобе нет тегов.
Content-Length Количество байт, присутствующих в теле ответа.
Content-Type Тип контента, указанный для blob-а. Тип контента по умолчанию — application/octet-stream.
Content-Range Показывает диапазон байт, который возвращается в случае, если клиент запросил подмножество blob, установив Range заголовок запроса.
ETag Содержит значение, которое можно использовать для выполнения операций условно. Для получения дополнительной информации см. раздел «Указать условные заголовки для операций с хранением blob». Если версия запроса — 2011-08-18 или более поздняя, значение ETag заключается в кавычки.
Content-MD5 Если у blob есть MD5-хэш и эта Get Blob операция заключается в чтении полного blob, этот заголовок ответа возвращается, чтобы клиент мог проверить целостность содержимого сообщения.

В версиях 2012-02-12 и более поздней установлена Put Blob MD5-хеш-значение блока блока, даже если Put Blob запрос не содержит заголовка MD5.

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

Если ни одно из этих наборов условий не trueявляется , значение для заголовка не возвращается Content-MD5 .

Если x-ms-range-get-content-md5 указано без Range заголовка, сервис возвращает статус 400 (Плохой запрос).

Если x-ms-range-get-content-md5 установлен на true «когда диапазон превышает 4 МиБ», сервис возвращает статус 400 (Плохой запрос).
x-ms-content-crc64 Если запрос — прочитать заданный диапазон и x-ms-range-get-content-crc64 установлен на true, запрос возвращает CRC64-хэш для этого диапазона, при условии, что размер диапазона меньше или равен 4 МиБ.

Если x-ms-range-get-content-crc64 указано без Range заголовка, сервис возвращает статус 400 (Плохой запрос).

Если x-ms-range-get-content-crc64 установлен на true «когда диапазон превышает 4 МиБ», сервис возвращает статус 400 (Плохой запрос).
Content-Encoding Возвращает значение, указанное для Content-Encoding заголовка запроса.
Content-Language Возвращает значение, указанное для Content-Language заголовка запроса.
Cache-Control Возвращается, если заголовок был заранее указан для blob.
Content-Disposition Возвращен для запросов с версией 2013-08-15 и более поздней. Этот заголовок возвращает значение, указанное для заголовка x-ms-blob-content-disposition .

Content-Disposition Поле заголовка ответа содержит дополнительную информацию о том, как обрабатывать полезную нагрузку ответа, и может использоваться для прикрепления дополнительных метаданных. Например, если заголовок установлен на attachment, это означает, что user-agent не должен отображать ответ. Вместо этого появляется диалог «Сохранить как сейв» с именем файла, отличным от указанного имени blob.
x-ms-blob-sequence-number Текущий номер последовательности для большого двоичного объекта страницы.

Этот заголовок не возвращается для блочных и добавленных капель.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Возвращает тип Blob'а.
x-ms-copy-completion-time: <datetime> Версия 2012-02-12 и позже. Заключительное время последней попытки Copy Blob операции, когда этот комок был целевой целью. Это значение может указать время завершения, прерывания или неудачной попытки копирования. Этот заголовок не появляется, если копия находится в ожидании, если этот blob никогда не был назначением в операции Copy Blob , или если этот blob был изменён после завершенной Copy Blob операции, использующей Set Blob Properties, Put Blob, или Put Block List.
x-ms-copy-status-description: <error string> Версия 2012-02-12 и позже. Появляется только тогда, когда x-ms-copy-status есть failed или pending. Описывает причину последнего неустранимого или неустранимого сбоя операции копирования. Этот заголовок не появляется, если этот blob никогда не был назначением в операции Copy Blob или если этот blob был изменён после завершенной Copy Blob операции, использующей Set Blob Properties, Put Blob, или Put Block List.
x-ms-copy-id: <id> Версия 2012-02-12 и позже. Идентификатор строки для последней попытки Copy Blob операции, где этот blob был целевой блобом. Этот заголовок не появляется, если этот blob никогда не был назначением в операции Copy Blob или если этот blob был изменён после завершенной Copy Blob операции, использующей Set Blob Properties, Put Blob, или Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Версия 2012-02-12 и позже. Содержит количество байт, скопированных, и общее количество байтов в исходном коде в последней попытке Copy Blob операции, где этот blob был целевой блобом. Он может показывать от 0 до Content-Length байт копирования. Этот заголовок не появляется, если этот blob никогда не был назначением в операции Copy Blob или если этот blob был изменён после завершенной Copy Blob операции, использующей Set Blob Properties, Put Blob, или Put Block List.
x-ms-copy-source: url Версия 2012-02-12 и позже. URL длиной до 2 KiB, указывающий исходный blob или файл, использованный в последней попытке Copy Blob операции, где этот blob был целевой блобом. Этот заголовок не появляется, если этот blob никогда не был назначением в операции Copy Blob или если этот blob был изменён после завершенной Copy Blob операции, использующей Set Blob Properties, Put Blob, или Put Block List.

URL, возвращаемый в этом заголовке, содержит любые параметры запроса, использованные при операции копирования на исходном блобе. Если URL содержит токен Shared Access Signature (SAS), подпись (sig параметр) не будет включена.
x-ms-copy-status: <pending | success | aborted | failed> Версия 2012-02-12 и позже. Состояние операции копирования, идентифицируемое x-ms-copy-id, со следующими значениями:

- success: Копия выполнена успешно.
- pending: Копирование в процессе. Проверьте x-ms-copy-status-description , замедляют ли перерывистые, не фатальные ошибки процесс копирования, но не вызывают ли сбои.
- aborted: Копия была завершена .Abort Copy Blob
- failed: Копия не получилась. См. описание статуса x-ms-copy-status для подробностей отказа.

Этот заголовок не появляется, если этот blob никогда не был назначением в операции Copy Blob или если этот blob был изменён после завершенной Copy Blob операции, использующей Set Blob Properties, Put Blob, или Put Block List.
x-ms-lease-duration: <infinite | fixed> Версия 2012-02-12 и позже. При аренде большого двоичного объекта указывает, является ли аренда бесконечной или фиксированной длительностью.
x-ms-lease-state: <available | leased | expired | breaking | broken> Версия 2012-02-12 и позже. Состояние по аренде этого блока.
x-ms-lease-status:<locked | unlocked> Текущее состояние аренды большого двоичного объекта.
x-ms-request-id Уникально идентифицирует сделанный запрос и может использоваться для устранения неполадок. Дополнительные сведения см. в статье Устранение неполадок с операциями API.
x-ms-version Указывает версию Blob Storage, использовавшуюся для выполнения запроса. Включено для запросов, сделанных с использованием версии 2009-09-19 и более поздней.

Этот заголовок также возвращается для анонимных запросов без указанной версии, если контейнер был помечен для публичного доступа с помощью версии Blob Storage 2009-09-19.
Accept-Ranges: bytes Указывает, что служба поддерживает запросы на частичное содержимое BLOB-объектов. Включено для запросов, выполненных с использованием версии 2011-08-18 и новее, а также для локального хранилища в SDK версии 1.6 и новее.
Date Значение даты и времени в формате UTC, созданное службой, указывающее время, когда был инициирован ответ.
Access-Control-Allow-Origin Возвращается, если запрос содержит Origin заголовок и CORS включен с правилом сопоставления. Этот заголовок возвращает значение исходного запроса в случае совпадения.
Access-Control-Expose-Headers Возвращается, если запрос содержит Origin заголовок и CORS включен с правилом сопоставления. Возвращает список заголовков ответов, которые должны быть представлены клиенту или эмитенту запроса.
Vary Возвращается со значением Origin заголовка при указании правил CORS. Подробности см. в статье CORS поддержки Azure Storage Services.
Access-Control-Allow-Credentials Возвращается, если запрос содержит Origin заголовок, а CORS включен с правилом сопоставления, которое не позволяет использовать все источники. Этот заголовок будет настроен на true.
x-ms-blob-committed-block-count Число зафиксированных блоков, присутствующих в большом двоичном объекте. Этот заголовок возвращается только для больших двоичных объектов добавления.
x-ms-server-encrypted: true/false Версия 2015-12-11 и более поздняя. Значение этого заголовка устанавливается так, true если данные blob и метаданные приложения полностью зашифрованы с помощью указанного алгоритма. В противном случае значение устанавливается в false (если blob не зашифрован или если зашифрованы только части blob или метаданных приложения).
x-ms-encryption-key-sha256 Версия 2019-02-02 и выше. Этот заголовок возвращается, если blob зашифрован ключом, предоставленным клиентом.
x-ms-encryption-context Версия 2021-08-06 и новее. Если задано значение свойства контекста шифрования, оно вернет заданное значение. Допустимо, только если иерархическое пространство имен включено для учетной записи.
x-ms-encryption-scope Версия 2019-02-02 и выше. Этот заголовок возвращается, если blob зашифрован с помощью области шифрования.
x-ms-blob-content-md5 Версия 2016-05-31 и позже. Если blob содержит MD5-хеш, и если запрос содержит заголовок диапазона (Range или x-ms-range), этот заголовок возвращается с значением всего значения MD5 всей blob. Это значение может быть равно значениям, возвращаемому в заголовке Content-MD5, при этом оно рассчитывается из запрошенного диапазона.
x-ms-client-request-id Может использоваться для устранения неполадок с запросами и соответствующими ответами. Значение этого заголовка равно значению заголовка x-ms-client-request-id, если оно присутствует в запросе, а значение содержит не более 1024 видимых символов ASCII. Если заголовок x-ms-client-request-id отсутствует в запросе, он отсутствует в ответе.
x-ms-last-access-time Версия 2020-02-10 и позже. Указывает последний раз, когда данные blob были получены на основе политики последнего отслеживания времени доступа аккаунта хранения. Заголовок не возвращается, если в аккаунте хранения нет политики отслеживания времени последнего доступа или если политика отключена. Для получения информации о настановке политики отслеживания времени последнего доступа аккаунта хранения см. API Blob Service.
x-ms-blob-sealed Версия 2019-12-12 и позже. Возвращался только для капель придатка. Если капля придатка была запечатана, значение будет равным true. Для получения дополнительной информации см. Приложение печати Blob
x-ms-immutability-policy-until-date Версия 2020-06-12 и выше. Указывает дату удержания до установленной на блобе. Это дата, до которой blob можно защитить от изменений или удаления. Возвращается только если на блобе установлена политика неизменяемости. Ценность этого заголовка указана в RFC1123 формате.
x-ms-immutability-policy-mode: unlocked/locked Версия 2020-06-12 и выше. Возвращается, если на блобе установлена политика неизменяемости. Значения: unlocked и locked. unlocked указывает на то, что пользователь может изменить политику, увеличив или уменьшив удержание до даты. locked означает, что такие действия запрещены.
x-ms-legal-hold: true/false Версия 2020-06-12 и выше. Этот заголовок не возвращается, если на blob нет юридического блока. Значение этого заголовка устанавливается так, true если blob содержит легальное удержание, и его значение равно true. В противном случае значение задаётся равным false , если blob содержит легальное владение и её значение равно false.
x-ms-owner Версия 2020-06-12 и выше, только для аккаунтов с включённым иерархическим пространством имён. Возвращает владельца-пользователя файла или каталога.
x-ms-group Версия 2020-06-12 и выше, только для аккаунтов с включённым иерархическим пространством имён. Возвращает группу владельцев файла или каталога.
x-ms-permissions Версия 2020-06-12 и выше, только для аккаунтов с включённым иерархическим пространством имён. Возвращает права доступа, установленные для пользователя, группы и других в файле или каталоге. Каждое отдельное разрешение находится в [r,w,x,-]{3} формате.
x-ms-acl Версия 2023-11-03 и выше. Только для аккаунтов с включённым иерархическим пространством имён. Возвращает объединённый список доступа и стандартного списка контроля доступа, которые настроены для пользователя, группы и других в файле или каталоге. Каждая запись контроля доступа (ACE) состоит из области применения, типа, идентификатора пользователя или группы, а также разрешений в формате [scope]:[type]:[id]:[permissions]. Область объёма указывает, что ACE принадлежит стандартному ACL для каталога; в противном случае default область действия подразумевается, и ACE принадлежит ACL доступа. Каждое отдельное разрешение находится в [r,w,x,-]{3} формате.
x-ms-resource-type Версия 2020-10-02 и выше, только для аккаунтов с включённым иерархическим пространством имён. Возвращает тип ресурса для пути, который может быть либо file , либо directory.

Заголовки отклика (структурированное тело)

С версии 2025-01-05 следующие заголовки будут возвращены, если запрос отправляет действительный x-ms-structured-body заголовок.

Заголовок ответа Description
Content-Length Будет длина закодированного ответа (не только длина возвращаемого содержимого blob).
x-ms-structured-body Значение этого заголовка равно значению, отправленному в запросе, которое в настоящее время должно быть XSM/1.0; properties=crc64.
x-ms-structured-content-length Значение этого заголовка — это длина возвращённого содержимого blob и всегда будет меньше Content-Length значения заголовка из-за кодирования сообщений.

Основная часть ответа

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

Пример ответа

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-blob-type: BlockBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Vary: Origin  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>

Authorization

Авторизация требуется при вызове любой операции доступа к данным в службе хранилища Azure. Вы можете авторизовать операцию Get Blob, как описано ниже.

Это важно

Корпорация Майкрософт рекомендует использовать идентификатор Microsoft Entra с управляемыми удостоверениями для авторизации запросов в службу хранилища Azure. Идентификатор Microsoft Entra обеспечивает более высокую безопасность и удобство использования по сравнению с авторизацией общего ключа.

Служба хранилища Azure поддерживает использование идентификатора Microsoft Entra для авторизации запросов к данным BLOB-объектов. С помощью идентификатора Microsoft Entra можно использовать управление доступом на основе ролей Azure (Azure RBAC) для предоставления разрешений субъекту безопасности. Субъект безопасности может быть пользователем, группой, субъектом-службой приложений или управляемым удостоверением Azure. Принципал безопасности проходит проверку подлинности с помощью Microsoft Entra ID, чтобы вернуть токен OAuth 2.0. Затем маркер можно использовать для авторизации запроса к службе BLOB-объектов.

Дополнительные сведения об авторизации с помощью идентификатора Microsoft Entra см. в статье Авторизация доступа к большим двоичным объектам с помощью идентификатора Microsoft Entra ID.

Permissions

Ниже приведены действия RBAC, необходимые для пользователя Microsoft Entra, группы, управляемого удостоверения или субъекта-службы для вызова операции Get Blob и минимально привилегированной встроенной роли Azure RBAC, которая включает в себя следующее:

Дополнительные сведения о назначении ролей с помощью Azure RBAC см. в статье Назначение роли Azure для доступа к данным BLOB-объектов.

Замечания

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

Если вы вызываете Get Blob блоб страницы без указания диапазона, сервис возвращает диапазон страниц до указанного значения заголовка x-ms-blob-content-length . Для страниц без содержимого сервис возвращает нули за эти байты.

Для blob приложения Get Blob операция возвращает заголовок x-ms-blob-committed-block-count . Этот заголовок показывает количество фиксированных блоков в блобе. Заголовок не возвращается для блобов блоков или блобов x-ms-blob-committed-block-count страницы.

Операция может быть выполнена Get Blob за две минуты на МиБ. Если операция в среднем длится более двух минут на МиБ, время работы заканчивается.

x-ms-version Заголовок необходим для извлечения blob-а, принадлежащего приватному контейнеру. Если blob относится к контейнеру, доступному для полного или частичного публичного доступа, любой клиент может прочитать его без указания версии; Версия сервиса не требуется для получения blob, принадлежащего публичному контейнеру. Для получения дополнительной информации см. раздел «Ограничить доступ к контейнерам и blobs».

Операция Get Blob над архивированным блочным блоком провалится.

Операции копирования

Чтобы определить, завершена ли операцияCopy Blob, сначала проверьте, совпадает x-ms-copy-id ли заголовочное значение целевой блоба с идентификатором копирования, предоставленным исходным вызовом .Copy Blob Совпадение гарантирует, что другое приложение не прервало копирование и не начало новую Copy Blob операцию. Далее проверьте заголовок x-ms-copy-status: success . Однако имейте в виду, что все операции записи на blob, кроме Lease, Put Pageи Put Block операций удаляют все x-ms-copy-* свойства blob. Эти свойства также не копируются Copy Blob операциями, использующими версии Blob Storage ранее 12.02.2012.

Замечание

URL, возвращаемый в x-ms-copy-source заголовке, содержит любые параметры запроса, использованные в операции копирования на исходном блобе. Если для доступа к исходному blob использовался токен Shared Access Signature (SAS), то токен SAS будет отображаться в x-ms-copy-source заголовке при Get Blob вызове на блобе получателя, за исключением того, что подпись (sig параметр запроса) будет удален.

Когда x-ms-copy-status: failed появляется в ответе, x-ms-copy-status-description содержит дополнительную информацию о неисправности Copy Blob .

Три поля каждого x-ms-copy-status-description значения описаны в следующей таблице:

Компонент Description
Код состояния HTTP Стандартное трёхзначное целое число, указывающее ошибку.
Код ошибки Ключевое слово, описывающее ошибку, предоставляемое Azure в элементе <ErrorCode> . Если элемент ErrorCode< не >отображается, используется ключевое слово, содержащее стандартный текст ошибки, связанный с трёхзначным HTTP-статусным кодом в спецификации HTTP. См. Общие коды ошибок REST API.
Информация Подробное описание неудачи, приложенное в кавычки.

x-ms-copy-status x-ms-copy-status-description Значения и распространённых сценариев отказа описаны в следующей таблице:

Это важно

Описания ошибок в этой таблице могут меняться без предупреждения, даже без изменения версии, поэтому они могут не совпадать с вашим текстом.

Scenario x-ms-copy-status значение x-ms-copy-status-description значение
Операция копирования завершена успешно. success empty
Пользователь прервал операцию копирования до завершения. Прервана empty
Произошёл сбой при чтении с исходного blob во время операции копирования, но операция будет повторена. Ожидающие 502 BadGateway "Обнаружена повторная ошибка при чтении источника. Повторите попытку. Время отказа: <время>»
Произошёл сбой при записи в целевой блок операции копирования, но операция будет повторена. Ожидающие 500 InternalServerError "Обнаружена повторная ошибка. Повторите попытку. Время отказа: <время>»
Неустранимый сбой произошел при чтении из исходного большого двоичного объекта операции копирования. ошибка 404 ResourceNotFound «Копирование не удалось при чтении исходного кода.»

Примечание: Когда сервис сообщает об этой ошибке, он возвращает ResourceNotFound элемент ErrorCode . Если в ответе элемент ErrorCode не появлялся, появляется стандартное представление HTTP-статуса NotFound, например ,
Период времени ожидания, ограничивающий все операции копирования, прошедшие. (В настоящее время тайм-аут составляет 2 недели.) ошибка 500 OperationCancelled "Копия превысила максимально допустимое время".
Операция копирования слишком часто не работала при чтении исходного источника и не соответствовала минимальному соотношению попыток к успеху. (Это время ожидания предотвращает повторную попытку очень плохого источника в течение двух недель до сбоя). ошибка 500 OperationCancelled "Сбой копирования при чтении источника".

x-ms-last-access-time отслеживает время обращения к данным blob на основе политики последнего отслеживания времени доступа аккаунта хранения. Доступ к метаданным blob не меняет его последнего времени доступа.

Выставление счетов

Запросы на оплату могут исходить от клиентов, использующих API хранилища BLOB-объектов, либо непосредственно через REST API хранилища BLOB-объектов, либо из клиентской библиотеки службы хранилища Azure. За эти запросы взимается плата за каждую транзакцию. Тип транзакции влияет на то, как будет взиматься плата со счета. Например, транзакции чтения относятся к другой категории выставления счетов, чем транзакции записи. В следующей таблице показана категория выставления счетов для Get Blob запросов в зависимости от типа учетной записи хранения:

Операция Тип учетной записи хранения Категория биллинга
Получить BLOB-объект Блочный BLOB-объект категории "Премиум".
Стандартная версия общего назначения v2
Стандартный общего назначения версии 1		 Операции чтения

Сведения о ценах для указанной категории выставления счетов см. в статье Цены на хранилище BLOB-объектов Azure.

См. также

Авторизация запросов к службе хранилища Azure
Коды состояний и ошибок
коды ошибок хранилища BLOB-объектов
Установка тайм-аутов для операций хранения Blob

  • Last updated on