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

Статья
03/16/2023

Операция Get Blob Properties возвращает все пользовательские метаданные, стандартные свойства HTTP и системные свойства большого двоичного объекта. Он не возвращает содержимое большого двоичного объекта.

Запрос

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

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

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

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

HEAD URI запроса метода	параметр "Версия HTTP"
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob`	HTTP/1.1

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

Параметры универсального кода ресурса (URI)

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

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

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

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

Заголовок запроса	Описание
`Authorization`	Обязательный. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
`Date` или `x-ms-date`	Обязательный. Задает время запроса в формате UTC. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
`x-ms-version`	Требуется для всех авторизованных запросов. Необязательно для анонимных запросов. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
`x-ms-lease-id: <ID>`	Необязательный элемент. Если указан этот заголовок, `Get Blob Properties` операция выполняется только при выполнении обоих следующих условий: — Аренда BLOB-объекта в настоящее время активна. — идентификатор аренды, указанный в запросе, соответствует идентификатору аренды большого двоичного объекта. Если любое из этих условий не выполняется, запрос завершается ошибкой и `Get Blob Properties` операция завершается с кодом состояния 412 (сбой условия).
`x-ms-upn`	Необязательный элемент. Версия 12.06.2020 и более поздняя. Допустимо для учетных записей с включенным иерархическим пространством имен. Если значения удостоверений пользователя, возвращаемые в `x-ms-owner` , имеют значение true, они преобразуются из Microsoft Entra идентификаторов объектов в имена субъектов-пользователей. Если значения false, они возвращаются как Microsoft Entra идентификаторы объектов. Значение по умолчанию — false. Обратите внимание, что идентификаторы объектов групп и приложений не переводятся, так как они не имеют уникальных понятных имен.
`x-ms-client-request-id`	Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы аналитики при включении ведения журнала аналитики хранилища. Мы настоятельно рекомендуем использовать этот заголовок при сопоставлении действий на стороне клиента с запросами, полученными сервером. Дополнительные сведения см. в статье Ведение журнала Аналитика Службы хранилища Azure.

Эта операция также поддерживает использование условных заголовков для возврата свойств большого двоичного объекта и метаданных только при выполнении условия. Дополнительные сведения см . в разделе Указание условных заголовков для операций с хранилищем 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 (ОК).

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

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

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

Заголовок ответа	Описание
`Last-Modified`	Дата и время последнего изменения BLOB-объекта. Дата в формате согласно RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках. Любая операция, которая изменяет BLOB-объект, в том числе обновление метаданных или свойств BLOB-объекта, изменяет время последнего изменения BLOB-объекта.
`x-ms-creation-time`	Версия 09.11.2017 и более поздняя. Дата и время создания большого двоичного объекта. Дата в формате согласно RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках.
`x-ms-meta-name:value`	Набор пар "имя-значение", которые соответствуют определяемым пользователем метаданным, связанным с этим большим двоичным объектом.
`x-ms-tag-count`	Версия 2019-12-12 и более поздние версии. Если большой двоичный объект содержит какие-либо теги, возвращает количество тегов, хранящихся в большом двоичном объекте. Этот заголовок не возвращается, если в большом двоичном объекте нет тегов.
`x-ms-blob-type:<BlockBlob\\|PageBlob\\|AppendBlob>`	Тип большого двоичного объекта.
`x-ms-copy-completion-time:<datetime>`	Версия 12.02.2012 и более поздние. Время завершения последней попытки операции `Copy Blob`, в которой этот большой двоичный объект был целевым. Это значение может указывать время завершенной, отмененной или неуспешной попытки копирования. Этот заголовок не отображается, если копирование находится в ожидании, если этот BLOB-объект никогда не был назначением в `Copy Blob` операции или если этот 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-объект был целевым 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`.
`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`. Этот заголовок не отображается, если этот BLOB-объект никогда не был назначением `Copy Blob` в операции или если он был изменен после завершения `Copy Blob` операции с использованием `Set Blob Properties`, `Put Blob`или `Put Block List`.
`x-ms-incremental-copy: true`	Версия 31.05.2016 и более поздняя. Включается, если большой двоичный объект является blob-объектом добавочного копирования.
`x-ms-copy-destination-snapshot:<datetime>`	Версия 31.05.2016 и более поздняя. Включается, если большой двоичный объект является добавочным копированием BLOB-объекта или добавочного копирования snapshot, если `x-ms-copy-status` выполнено успешно. Время моментального снимка последнего успешного добавочного копирования snapshot для этого BLOB-объекта.
`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>`	Состояние аренды большого двоичного объекта.
`Content-Length`	Размер большого двоичного объекта в байтах. Для страничного BLOB-объекта этот заголовок возвращает значение заголовка, хранящегося `x-ms-blob-content-length` в большом двоичном объекте.
`Content-Type`	Тип контента, указанный для большого двоичного объекта. Если тип контента не указан, по умолчанию используется `application/octet-stream`тип контента .
`Etag`	ETag содержит значение, которое позволяет выполнять операции условно. Дополнительные сведения см. в разделе Указание условных заголовков для операций с хранилищем BLOB-объектов. Если версия запроса — 2011-08-18 или более поздняя, значение ETag заключается в кавычки.
`Content-MD5`	Если заголовок `Content-MD5` задан для большого двоичного объекта, то возвращается этот заголовок, чтобы клиент мог проверить целостность содержимого сообщения. В версии 2012-02-12 и более поздних задает значение MD5 блочного BLOB-объекта, `Put Blob` даже если `Put Blob` запрос не содержит заголовок MD5.
`Content-Encoding`	Если заголовок запроса `Content-Encoding` уже был задан для большого двоичного объекта, то значение возвращается в этом заголовке.
`Content-Language`	Если заголовок запроса `Content-Language` уже был задан для большого двоичного объекта, то значение возвращается в этом заголовке.
`Content-Disposition`	Если заголовок запроса `Content-Disposition` уже был задан для большого двоичного объекта, то значение возвращается в этом заголовке для запросов в версиях начиная с 2013-08-15. Поле заголовка ответа `Content-Disposition` предоставляет дополнительные сведения о том, как обрабатывать полезные данные ответа, а также может использоваться для присоединения дополнительных метаданных. Например, если для заголовка задано значение `attachment`, это означает, что агент пользователя не должен отображать ответ, а отображать диалоговое окно Сохранить как.
`Cache-Control`	Если заголовок запроса `Cache-Control` уже был задан для большого двоичного объекта, то значение возвращается в этом заголовке.
`x-ms-blob-sequence-number`	Текущий порядковый номер для страничного большого двоичного объекта. Этот заголовок не возвращается для блочных или добавочных BLOB-объектов. Этот заголовок не возвращается для блочных BLOB-объектов.
`x-ms-request-id`	Этот заголовок однозначно идентифицирует выполненный запрос, и его можно использовать для устранения неполадок запроса. Дополнительные сведения см. в разделе Устранение неполадок с операциями API.
`x-ms-version`	Указывает версию хранилища BLOB-объектов, которая используется для выполнения запроса. Этот заголовок возвращается для запросов к версии 2009-09-19 и более поздних версий. Этот заголовок также возвращается для анонимных запросов без указанной версии, если контейнер был помечен как общедоступный с помощью Хранилища BLOB-объектов версии 2009-09-19.
`Date`	Значение даты и времени в формате UTC, созданное службой, указывающее время, когда был инициирован ответ.
`Accept-Ranges: bytes`	Указывает, что служба поддерживает запросы для частичного содержимого большого двоичного объекта. Включено для запросов, выполненных с использованием версии 2013-08-15 и более поздних версий.
`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-access-tier`	Версия 17.04.2017 и более поздняя. Уровень страничного BLOB-объекта в учетной записи хранилище класса Premium или уровне блочного BLOB-объекта в хранилище BLOB-объектов или учетной записи общего назначения версии 2. Список разрешенных уровней страничных BLOB-объектов категории "Премиум" см. в статье Высокопроизводительные хранилище класса Premium и управляемые диски для виртуальных машин. Для хранилища BLOB-объектов или учетной записи общего назначения версии 2 допустимые значения: `Hot`, `Cool`, `Cold`и `Archive`. Примечание:`Cold` tier поддерживается для версии 2021-12-02 и более поздних версий. Подробные сведения о разных уровнях блочных BLOB-объектов для учетной записи BLOB-объектов категории "Стандартный" см. в статье Горячий, холодный и архивный уровни хранилища.
`x-ms-access-tier-inferred: true`	Версия 17.04.2017 и более поздняя. Только для страничных BLOB-объектов в учетной записи хранилище класса Premium. Если уровень доступа не задан явным образом для большого двоичного объекта, уровень определяется на основе его длины содержимого, и этот заголовок возвращается со значением `true`. Для блочных BLOB-объектов в Хранилище BLOB-объектов или учетной записи общего назначения версии 2, если для blob-объекта не задан уровень доступа, вы можете определить уровень из свойств учетной записи хранения. Этот заголовок задается только в том случае, если определяется уровень блочного BLOB-объекта.
`x-ms-archive-status`	Версия 17.04.2017 и более поздняя. Для хранилища BLOB-объектов или учетной записи общего назначения версии 2 допустимые значения: `rehydrate-pending-to-hot`, `rehydrate-pending-to-cool`и `rehydrate-pending-to-cold`. Если большой двоичный объект восстанавливается и является неполным, возвращается этот заголовок, который указывает на ожидание восстановления и отображает целевой уровень. Подробные сведения о разных уровнях блочных BLOB-объектов для учетной записи BLOB-объектов категории "Стандартный" см. в статье Горячий, холодный и архивный уровни хранилища.
`x-ms-access-tier-change-time`	Версия 17.04.2017 и более поздняя. Указывает время последнего изменения уровня в объекте. Этот заголовок возвращается только в том случае, если был задан уровень в блочных BLOB-объектах. Дата в формате согласно RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках. Дополнительные сведения о разных уровнях блочных BLOB-объектов для учетной записи BLOB-объектов категории "Стандартный" см. в статье Горячий, холодный и архивный уровни хранилища.
`x-ms-client-request-id`	Можно использовать для устранения неполадок с запросами и соответствующими ответами. Значение этого заголовка равно значению заголовка `x-ms-client-request-id` , если он присутствует в запросе, и значение не более 1024 видимых символов ASCII. Если заголовок `x-ms-client-request-id` отсутствует в запросе, этот заголовок отсутствует в ответе.
`x-ms-rehydrate-priority`	Версия 12.12.2019 и более поздняя. Если объект находится в состоянии ожидания восстановления, этот заголовок возвращается с приоритетом восстановления. Допустимые значения: `High`/`Standard`. Подробные сведения о уровне блочных BLOB-объектов стандартной учетной записи BLOB-объектов см. в разделе Горячий, холодный и архивный уровни хранилища.
`x-ms-or-{policy-id}_{rule-id}`	Версия 12.12.2019 и более поздние версии, возвращаемые только для блочных BLOB-объектов. `policy-id` — это значение GUID, представляющее идентификатор политики репликации объектов в учетной записи хранения. `rule-id` — это значение GUID, представляющее идентификатор правила политики в контейнере BLOB-объектов. Если учетная запись включена `ObjectReplication`, значение этого заголовка представляет состояние репликации большого двоичного объекта с заданными идентификаторами политики и правил, или `completefailed`.
`x-ms-or-policy-id`	Версия 12.12.2019 и более поздние версии, возвращаемые только для блочных BLOB-объектов. Если учетная запись включена `ObjectReplication`, значение этого заголовка представляет политику, которая управляет репликацией.
`x-ms-last-access-time`	Версия 10.02.2020 и более поздняя. Указывает время последнего доступа к данным BLOB-объекта на основе политики отслеживания времени последнего доступа учетной записи хранения. Заголовок не возвращается, если учетная запись хранения не имеет политики отслеживания времени последнего доступа или политика отключена. Сведения о настройке политики отслеживания времени последнего доступа учетной записи хранения см. в разделе API хранилища BLOB-объектов.
`x-ms-blob-sealed`	Версия 12.12.2019 и более поздние версии, возвращаемые только для добавочных 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 и более поздняя. Этот заголовок не возвращается, если большой двоичный объект не удерживается по закону. Значение этого заголовка равно true , если большой двоичный объект содержит удержание по юридическим причинам, а его значение равно true. В противном случае устанавливается значение false, если большой двоичный объект содержит удержание по юридическим причинам, а его значение false.
`x-ms-owner`	Версия 12.06.2020 и более поздняя. Только для учетных записей с включенным иерархическим пространством имен. Возвращает пользователя-владельца файла или каталога.
`x-ms-group`	Версия 12.06.2020 и более поздняя. Только для учетных записей с включенным иерархическим пространством имен. Возвращает группу владельцев файла или каталога.
`x-ms-permissions`	Версия 12.06.2020 и более поздняя. Только для учетных записей с включенным иерархическим пространством имен. Возвращает разрешения, заданные для пользователя, группы и других элементов в файле или каталоге. Каждое отдельное разрешение имеет формат [r,w,x,-]{3} .
`x-ms-resource-type`	Версия 2020-10-02 и более поздняя. Только для учетных записей с включенным иерархическим пространством имен. Возвращает тип ресурса для пути, который может иметь значение `file` или `directory`.
`x-ms-expiry-time`	Версия 10.02.2020 и более поздняя. Только для учетных записей с включенным иерархическим пространством имен. Возвращает время окончания срока действия, заданное для большого двоичного объекта. Возвращается только для файлов, для которых задано время окончания срока действия.

Текст ответа

Нет.

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

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
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 Properties как описано ниже.

Служба хранилища 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 Properties операции, а также встроенная роль Azure RBAC с минимальными привилегиями, которая включает это действие:

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

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

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

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

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

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

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

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

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

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

SAS для службы

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

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

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

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

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

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

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

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

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

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

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

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 "Сбой копирования при чтении источника". Примечание. Когда служба сообщает об этой базовой ошибке, она возвращается `ResourceNotFound` в элементе <ErrorCode> . Если в ответе не <появился элемент ErrorCode> , появится стандартное строковое представление состояния HTTP, например `NotFound`, .
Время ожидания, ограничивающее все операции копирования, истекло. (В настоящее время время время ожидания составляет две недели.)	сбой	500 (операция отменена). «Копирование превысило максимально допустимое время».
Операция копирования слишком часто завершалась сбоем при чтении из источника и не соответствовала минимальному соотношению попыток к успешному выполнению. (Это время ожидания предотвращает повторную попытку очень плохого источника в течение двух недель до сбоя).	сбой	500 (операция отменена). «Копирование завершилось ошибкой во время чтения данных из источника».

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

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

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

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

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

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

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