Get BLOB (Получение BLOB-объекта)

Статья
03/16/2023

Операция Get 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 эмулированной службы хранилища

При выполнении запроса к эмулированной службе хранилища укажите имя узла эмулятора и порт Хранилище BLOB-объектов Azure в качестве 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 запроса можно указать следующие дополнительные параметры:

Параметр	Описание
`snapshot`	Необязательный элемент. Параметр snapshot является непрозрачным `DateTime` значением, которое при его наличии указывает большой двоичный объект, snapshot для извлечения. Дополнительные сведения о работе с моментальными снимками BLOB-объектов см. в разделе Create snapshot BLOB-объекта.
`versionid`	Необязательно, версия 2019-12-12 и более поздние версии. Параметр `versionid` является непрозрачным `DateTime` значением, которое при наличии указывает версию извлекаемого большого двоичного объекта.
`timeout`	Необязательный элемент. Параметр `timeout` указывается в секундах. Дополнительные сведения см. в разделе Установка времени ожидания для операций с хранилищем BLOB-объектов.

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

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

Заголовок запроса	Описание
`Authorization`	Обязательный. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
`Date` или `x-ms-date`	Обязательный. Задает время запроса в формате UTC. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
`x-ms-version`	Требуется для всех авторизованных запросов. Необязательный параметр для анонимных запросов. Задает версию операции, используемой для этого запроса. Если этот заголовок не указан для анонимного запроса, служба выполняет запрос с версией 2009-09-19. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
`Range`	Необязательный элемент. Возвращает байты большого двоичного объекта только в указанном диапазоне.
`x-ms-range`	Необязательный элемент. Возвращает байты большого двоичного объекта только в указанном диапазоне. Если заданы оба параметра, `Range` и `x-ms-range`, то служба использует значение `x-ms-range`. Если не указан ни диапазон, возвращается все содержимое большого двоичного объекта. Дополнительные сведения см. в разделе Указание заголовка диапазона для операций с хранилищем BLOB-объектов.
`x-ms-lease-id: <ID>`	Необязательный элемент. Если указан этот заголовок, операция выполняется только в том случае, если выполняются оба следующих условия: — Аренда 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-md5` и `x-ms-range-get-content-crc64` , запрос завершается ошибкой с ошибкой 400 (недопустимый запрос). Этот заголовок поддерживается в версиях 2019-02-02 и более поздних версиях.
`Origin`	Необязательный элемент. Указывает источник, от которого выдан запрос. Наличие этого заголовка приводит к появлению в ответе заголовков совместного использования ресурсов (CORS).
`x-ms-upn`	Необязательный элемент. Версия 2023-11-03 и более поздняя. Допустимо для учетных записей с включенным иерархическим пространством имен. Если значение равно true, значения идентификаторов пользователей, возвращаемые в `x-ms-owner`заголовках , `x-ms-group` и `x-ms-acl` ответов, будут преобразованы из Microsoft Entra идентификаторов объектов в имена субъектов-пользователей. Если значение равно false, они возвращаются в виде идентификаторов Microsoft Entra объектов. Значение по умолчанию — false. Обратите внимание, что идентификаторы объектов групп и приложений не переводятся, так как они не имеют уникальных понятных имен.
`x-ms-client-request-id`	Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы аналитики при включении ведения журнала аналитики хранилища. Мы настоятельно рекомендуем использовать этот заголовок при сопоставлении действий на стороне клиента с запросами, полученными сервером. Дополнительные сведения см. в статье Сведения о ведении журнала Аналитика Службы хранилища Azure.

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

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

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

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

Текст запроса

Нет.

Ответ

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

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

Успешная операция считывания полного большого двоичного объекта возвращает код состояния 200 (ОК).

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

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

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

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

Синтаксис	Описание
`Last-Modified`	Дата и время последнего изменения большого двоичного объекта. Дата в формате согласно RFC 1123. Любая операция, которая изменяет большой двоичный объект, включая обновление метаданных или свойств большого двоичного объекта, изменяет время последнего изменения большого двоичного объекта.
`x-ms-creation-time`	Версия 09.11.2017 и более поздняя. Дата и время создания большого двоичного объекта. Дата в формате согласно RFC 1123.
`x-ms-meta-name:value`	Набор пар "имя-значение", связанных с этим blob-объектом в качестве определяемых пользователем метаданных.
`x-ms-tag-count`	Версия 12.12.2019 и более поздняя. Если большой двоичный объект содержит теги, этот заголовок возвращает количество тегов, хранящихся в большом двоичном объекте. Заголовок не возвращается, если в большом двоичном объекте нет тегов.
`Content-Length`	Число байтов в тексте ответа.
`Content-Type`	Тип контента, указанный для большого двоичного объекта. Тип содержимого по умолчанию — `application/octet-stream`.
`Content-Range`	Указывает диапазон байтов, возвращаемых в случае, если клиент запросил подмножество большого двоичного объекта, задав `Range` заголовок запроса.
`ETag`	Содержит значение, которое можно использовать для условного выполнения операций. Дополнительные сведения см . в разделе Указание условных заголовков для операций с хранилищем BLOB-объектов. Если версия запроса — 18.08.2011 или более поздняя, значение ETag заключено в кавычки.
`Content-MD5`	Если большой двоичный объект имеет хэш MD5 и эта операция `Get Blob` должна прочитать весь большой двоичный объект, то возвращается этот заголовок ответа, чтобы клиент смог проверить целостность содержимого сообщения. В версии 2012-02-12 и более поздних задает хэш-значение MD5 блочного BLOB-объекта, `Put Blob` даже если `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`	Возвращается, если заголовок был ранее указан для большого двоичного объекта.
`Content-Disposition`	Возвращается для запросов к 2013-08-15 и последующей версии. Заголовок возвращает значение, которое было указано для заголовка `x-ms-blob-content-disposition`. Поле `Content-Disposition` заголовка ответа содержит дополнительные сведения о том, как обрабатывать полезные данные ответа, и его можно использовать для вложения дополнительных метаданных. Например, если для заголовка задано значение `attachment`, это означает, что агент пользователя не должен отображать ответ. Вместо этого отображается диалоговое окно Сохранить как с именем файла, отличного от указанного имени большого двоичного объекта.
`x-ms-blob-sequence-number`	Текущий порядковый номер для страничного большого двоичного объекта. Этот заголовок не возвращается для блочных blob-объектов или добавочных BLOB-объектов.
`x-ms-blob-type: <BlockBlob \| PageBlob \| AppendBlob>`	Возвращает тип большого двоичного объекта.
`x-ms-copy-completion-time: <datetime>`	Версия 12.02.2012 и более поздняя. Время завершения последней попытки `Copy Blob` операции, в которой этот большой двоичный объект был конечным BLOB-объектом. Это значение может указывать время завершенной, отмененной или неуспешной попытки копирования. Этот заголовок не отображается, если копирование ожидается, если этот большой двоичный объект никогда не был назначением в `Copy Blob` операции или если этот большой двоичный объект был изменен после завершения `Copy Blob` операции, которая использовала `Set Blob Properties`, `Put Blob`или `Put Block List`.
`x-ms-copy-status-description: <error string>`	Версия 12.02.2012 и более поздняя. Отображается только в том случае, если `x-ms-copy-status` имеет значение `failed` или `pending`. Описывает причину последнего неустранимого или устранимого сбоя операции копирования. Этот заголовок не отображается, если этот большой двоичный объект никогда не был назначением `Copy Blob` в операции или если этот большой двоичный объект был изменен после завершения `Copy Blob` операции, которая использовала `Set Blob Properties`, `Put Blob`или `Put Block List`.
`x-ms-copy-id: <id>`	Версия 12.02.2012 и более поздняя. Строковый идентификатор последней попытки `Copy Blob` операции, в которой этот большой двоичный объект был конечным BLOB-объектом. Этот заголовок не отображается, если этот большой двоичный объект никогда не был назначением `Copy Blob` в операции или если этот большой двоичный объект был изменен после завершения `Copy Blob` операции, которая использовала `Set Blob Properties`, `Put Blob`или `Put Block List`.
`x-ms-copy-progress: <bytes copied/bytes total>`	Версия 12.02.2012 и более поздняя. Содержит количество скопированных байтов и общее количество байтов в источнике в последней попытке `Copy Blob` операции, в которой этот BLOB-объект был конечным. Он может отображать от 0 до `Content-Length` байтов, скопированных. Этот заголовок не отображается, если этот большой двоичный объект никогда не был назначением `Copy Blob` в операции или если этот большой двоичный объект был изменен после завершения `Copy Blob` операции, которая использовала `Set Blob Properties`, `Put Blob`или `Put Block List`.
`x-ms-copy-source: url`	Версия 12.02.2012 и более поздняя. URL-адрес длиной до 2 КиБ, указывающий исходный BLOB-объект или файл, использованный при последней попытке `Copy Blob` операции, где этот BLOB-объект был целевым BLOB-объектом. Этот заголовок не отображается, если этот большой двоичный объект никогда не был назначением `Copy Blob` в операции или если этот большой двоичный объект был изменен после завершения `Copy Blob` операции, которая использовала `Set Blob Properties`, `Put Blob`или `Put Block List`. URL-адрес, возвращаемый в этом заголовке, содержит все параметры запроса, которые использовались в операции копирования исходного BLOB-объекта, включая маркер подписанного URL-адреса (SAS), который использовался для доступа к исходному BLOB-объекту.
`x-ms-copy-status: <pending \| success \| aborted \| failed>`	Версия 12.02.2012 и более поздняя. Состояние операции копирования, определяемой x-ms-copy-id, со следующими значениями: - `success`: копирование выполнено успешно. - `pending`: выполняется копирование. Проверьте `x-ms-copy-status-description` , если периодические, неустранимые ошибки замедляют процесс копирования, но не приводят к сбою. - `aborted`: копирование было завершено на `Abort Copy Blob`. - `failed`: сбой копирования. Дополнительные сведения см. в разделе x-ms-copy-status-description. Этот заголовок не отображается, если этот большой двоичный объект никогда не был назначением `Copy Blob` в операции или если этот большой двоичный объект был изменен после завершения `Copy Blob` операции, в которую использовались `Set Blob Properties`, `Put Blob`или `Put Block List`.
`x-ms-lease-duration: <infinite \| fixed>`	Версия 12.02.2012 и более поздняя. Когда большой двоичный объект получил аренду, указывает, какой срок имеет аренда — конечный или бесконечный.
`x-ms-lease-state: <available \| leased \| expired \| breaking \| broken>`	Версия 12.02.2012 и более поздняя. Состояние аренды большого двоичного объекта.
`x-ms-lease-status:<locked \| unlocked>`	Текущее состояние аренды большого двоичного объекта.
`x-ms-request-id`	Уникально идентифицирует выполненный запрос и может использоваться для устранения неполадок запроса. Дополнительные сведения см. в статье Устранение неполадок с операциями API.
`x-ms-version`	Указывает версию хранилища BLOB-объектов, которая использовалась для выполнения запроса. Включено для запросов, выполненных с использованием версии 2009-09-19 и более поздних версий. Этот заголовок также возвращается для анонимных запросов без указанной версии, если контейнер был помечен для общего доступа с помощью хранилища BLOB-объектов версии 2009-09-19.
`Accept-Ranges: bytes`	Указывает, что служба поддерживает запросы для частичного содержимого большого двоичного объекта. Включено для запросов, выполненных с использованием версии 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 .
`Access-Control-Allow-Credentials`	Возвращается, если запрос включает заголовок `Origin` , а CORS включен с правилом сопоставления, которое не разрешает все источники. Этот заголовок будет иметь значение `true`.
`x-ms-blob-committed-block-count`	Количество зафиксированных блоков, присутствующих в большом двоичном объекте. Этот заголовок возвращается только для добавочных BLOB-объектов.
`x-ms-server-encrypted: true/false`	Версия 2015-12-11 и более поздние версии. Этот заголовок имеет значение , `true` если данные большого двоичного объекта и метаданные приложения полностью зашифрованы с помощью указанного алгоритма. В противном случае устанавливается `false` значение (при незашифрованном большом двоичном объекте или если шифруются только части большого двоичного объекта или метаданных приложения).
`x-ms-encryption-key-sha256`	Версия 2019-02-02 и более поздние. Этот заголовок возвращается, если большой двоичный объект зашифрован с помощью ключа, предоставленного клиентом.
`x-ms-encryption-context`	Версия 2021-08-06 и более поздние. Если задано значение свойства контекста шифрования, возвращается заданное значение. Допустимо, только если для учетной записи включено иерархическое пространство имен.
`x-ms-encryption-scope`	Версия 2019-02-02 и более поздние. Этот заголовок возвращается, если большой двоичный объект зашифрован с помощью область шифрования.
`x-ms-blob-content-md5`	Версия 31.05.2016 и более поздняя. Если большой двоичный объект имеет хэш MD5 и запрос содержит заголовок диапазона (Range или x-ms-range), этот заголовок ответа возвращается со значением MD5 всего большого двоичного объекта. Это значение может быть равно или не совпадать со значением, возвращаемым в заголовке 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-объектов.
`x-ms-blob-sealed`	Версия 2019-12-12 и более поздние версии. Возвращается только для добавочных BLOB-объектов. Если добавочный BLOB-объект запечатан, значение будет равно `true`. Дополнительные сведения см. в разделе Добавление уплотнения BLOB-объекта.
`x-ms-immutability-policy-until-date`	Версия 12.06.2020 и более поздняя. Указывает срок хранения до даты, установленной для большого двоичного объекта. Это дата, до которой blob-объект можно защитить от изменения или удаления. Возвращается только в том случае, если для большого двоичного объекта задана политика неизменности. Значение этого заголовка имеет формат RFC1123.
`x-ms-immutability-policy-mode: unlocked/locked`	Версия 12.06.2020 и более поздняя. Возвращается, если для большого двоичного объекта задана политика неизменяемости. Значения: `unlocked` и `locked`. `unlocked` указывает, что пользователь может изменить политику, увеличив или уменьшив срок хранения до даты. `locked` указывает, что эти действия запрещены.
`x-ms-legal-hold: true/false`	Версия 12.06.2020 и более поздняя. Этот заголовок не возвращается, если для большого двоичного объекта нет удержания по юридическим причинам. Если большой двоичный объект содержит удержание по юридическим причинам, то значение этого заголовка равно `truetrue`. В противном случае устанавливается значение `false` , если большой двоичный объект содержит удержание по юридическим причинам и его значение равно `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]`. Область `default` указывает, что ACE принадлежит ACL по умолчанию для каталога; в противном случае область неявно, а ACE принадлежит к ACL доступа. Каждое отдельное разрешение имеет `[r,w,x,-]{3}` формат.
`x-ms-resource-type`	Версия 2020-10-02 и более поздние версии, только для учетных записей с включенным иерархическим пространством имен. Возвращает тип ресурса для пути, который может иметь значение `file` или `directory`.

Текст ответа

Текст ответа содержит большой двоичный объект.

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

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>

Авторизация

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

Важно!

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

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

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

Разрешения

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

Действие Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
Встроенная роль с наименьшими привилегиями:читатель данных BLOB-объектов хранилища

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

Подписанный URL-адрес (SAS) обеспечивает безопасный делегированный доступ к ресурсам в учетной записи хранения. С помощью SAS вы можете детально контролировать, как клиент может получить доступ к данным. Вы можете указать, к какому ресурсу может обращаться клиент, какие разрешения у него есть для этих ресурсов, а также срок действия SAS.

Операция Get Blob поддерживает три типа подписанных URL-адресов: SAS делегирования пользователей, SAS службы и SAS учетной записи.

Для обеспечения безопасности рекомендуется использовать Microsoft Entra учетные данные, а не ключ учетной записи хранения, который может быть проще скомпрометирован. Если для разработки приложения требуются подписанные URL-адреса, по возможности используйте учетные данные Microsoft Entra, чтобы создать SAS для делегирования пользователей.

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

SAS для делегирования пользователей

SAS для делегирования пользователей защищен с помощью учетных данных Microsoft Entra, а также разрешений, указанных для SAS.

Get Blob Для вызова операции с использованием маркера SAS, делегированного контейнеру или ресурсу BLOB-объекта, требуется разрешение на чтение (r) в составе маркера SAS делегирования пользователя.

Дополнительные сведения о SAS для делегирования пользователей см. в статье Create SAS делегирования пользователей.

SAS для службы

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

Get Blob Для вызова операции с помощью маркера SAS, делегированного контейнеру или ресурсу BLOB-объекта, требуется разрешение на чтение (r) в составе маркера SAS службы.

Дополнительные сведения о SAS службы см. в статье Create SAS службы.

SAS для учетной записи

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

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

Операция	Подписанная служба	Подписанный тип ресурса	Подписанное разрешение
Get BLOB (Получение BLOB-объекта)	Большой двоичный объект (b)	Объект (o)	Чтение (r)

Дополнительные сведения о SAS учетной записи см. в статье Create SAS учетной записи.

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

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

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

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

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

Заголовок x-ms-version необходим для получения большого двоичного объекта, принадлежащего частному контейнеру. Если большой двоичный объект принадлежит контейнеру, доступного для полного или частичного общего доступа, любой клиент может считывать его без указания версии; Версия службы не требуется для получения большого двоичного объекта, который принадлежит общедоступному контейнеру. Дополнительные сведения см. в разделе Ограничение доступа к контейнерам и BLOB-объектам.

Операция Get Blob с архивным блочный BLOB-объект завершится ошибкой.

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

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

Предупреждение

URL-адрес, возвращаемый в заголовке x-ms-copy-source , содержит все параметры запроса, которые использовались в операции копирования исходного BLOB-объекта. Если вы используете маркер SAS для доступа к исходному BLOB-объекту, этот маркер SAS будет отображаться в заголовке x-ms-copy-source при Get Blob вызове в целевом BLOB-объекте.

Когда параметр x-ms-copy-status: failed выводится в ответе, x-ms-copy-status-description содержит дополнительные сведения об ошибке Copy Blob.

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

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

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

Важно!

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

Сценарий	Значение x-ms-copy-status	Значение x-ms-copy-status-description
Операция копирования успешно завершена.	Успешное завершение	пустых
Пользователь прекратил операцию копирования до завершения.	aborted	пустых
Во время считывания данных из исходного большого двоичного объекта возникла ошибка операции копирования, однако операция будет повторена.	ожидание	502 (неверный шлюз). «Во время чтения данных из источника возникла ошибка, предполагающая повтор операции. Попытка будет повторена. Время сбоя: <время>"
Во время записи в целевой большой двоичный объект возникла ошибка операции копирования, однако операция будет повторена.	ожидание	500 (внутренняя ошибка сервера). «Обнаружена ошибка, предполагающая повтор операции. Попытка будет повторена. Время сбоя: <время>"
Во время считывания данных из исходного большого двоичного объекта возникла неустранимая ошибка операции копирования.	сбой	404 (ресурс не найден). «Возникла ошибка копирования во время чтения данных из источника». Примечание: Когда служба сообщает об этой базовой ошибке, она возвращается `ResourceNotFound` в элементе `ErrorCode` . Если в ответе нет `ErrorCode` элемента, отображается стандартное строковое представление состояния HTTP, например `NotFound`, .
Время ожидания, ограничивающее все операции копирования, истекло. (В настоящий момент время ожидания составляет 2 недели.)	сбой	500 (операция отменена). «Копирование превысило максимально допустимое время».
Операция копирования слишком часто завершалась сбоем при чтении из источника и не соответствовала минимальному соотношению попыток к успешному выполнению. (Это время ожидания предотвращает повторную попытку очень плохого источника в течение двух недель до сбоя).	сбой	500 (операция отменена). «Копирование завершилось ошибкой во время чтения данных из источника».

x-ms-last-access-time отслеживает время доступа к данным большого двоичного объекта на основе политики отслеживания времени последнего доступа учетной записи хранения. При доступе к метаданным большого двоичного объекта время последнего доступа не изменяется.

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

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

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

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

См. также раздел

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

Поделиться через