Получение свойств BLOB-объектов

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

Request

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

URI запроса метода HEAD Версия 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, а затем имя эмулированной учетной записи хранения:

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

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

Параметры URI

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

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

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

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

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

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

Если одно из этих условий не выполняется, запрос завершается ошибкой, а Get Blob Properties операция завершается ошибкой с кодом состояния 412 (ошибка предварительного условия).
x-ms-upn Optional. Версия 2020-06-12 и выше. Действительно для учетных записей с включенным иерархическим пространством имен. Если значение равно true, значения удостоверений пользователя, возвращаемые в заголовках x-ms-owner, x-ms-group и x-ms-acl ответа, будут преобразованы из идентификаторов объектов Microsoft Entra в имена участников-пользователей. Если значение равно false, они возвращаются как идентификаторы объектов Microsoft Entra. Значение по умолчанию равно false. Обратите внимание, что идентификаторы групп и объектов приложения не преобразуются, так как они не имеют уникальных понятных имен.
x-ms-client-request-id Optional. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы аналитики при включении ведения журнала аналитики хранилища. Настоятельно рекомендуется использовать этот заголовок при сопоставлении действий на стороне клиента с запросами, полученными сервером. Дополнительные сведения см. в статье Сведения о ведении журнала Azure Storage Analytics.

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

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

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

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

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

None.

Response

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

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

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

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

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

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

Заголовок ответа Description
Last-Modified Дата и время последнего изменения большого двоичного объекта. Формат даты следует RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках.

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

Обратите внимание, что это Last-Modified не будет возвращено для управляемых дисков и снимков управляемых дисков размером более 4 ТиБ.
x-ms-creation-time Версия 2017-11-09 и выше. Дата и время создания большого двоичного объекта. Формат даты следует 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> Версия 2012-02-12 и выше. Время завершения последней попытки Copy Blob операции, в которой этот большой двоичный объект был целевым большим двоичным объектом. Это значение может указать время завершения, прерывания или неудачной попытки копирования. Этот заголовок не отображается, если копия находится в ожидании, если этот большой двоичный объект никогда не был назначен в Copy 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 есть или failedpending. Описывает причину сбоя неустранимая или неустранимая операция копирования. Этот заголовок не отображается, если этот большой двоичный объект никогда не был местом назначения в Copy Blob операции или если этот большой двоичный объект был изменен после завершения Copy Blob операции, в которой используются Set Blob Properties, Put Blob, или Put Block List.
x-ms-copy-id: <id> Версия 2012-02-12 и выше. Строковый идентификатор для последней попытки Copy Blob операции, где этот большой двоичный объект был целевым большим двоичным объектом. Этот заголовок не отображается, если этот большой двоичный объект никогда не был местом назначения в Copy Blob операции или если этот большой двоичный объект был изменен после завершения Copy Blob операции, в которой используются Set Blob Properties, Put Blob, или Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Версия 2012-02-12 и выше. Содержит количество скопированных байтов и общее количество байтов в источнике в последней попытке Copy Blob , где этот большой двоичный объект был целевым большим двоичным объектом. Может показывать от 0 до Content-Length скопированных байт. Этот заголовок не отображается, если этот большой двоичный объект никогда не был местом назначения в Copy Blob операции или если этот большой двоичный объект был изменен после завершения Copy Blob операции, в которой используются Set Blob Properties, Put Blob, или Put Block List.
x-ms-copy-source: url Версия 2012-02-12 и выше. URL-адрес длиной до 2 КБ, указывающий исходный большой двоичный объект, который использовался в последней попытке Copy Blob операции, где этот большой двоичный объект был целевым большим двоичным объектом. Этот заголовок не отображается, если этот большой двоичный объект никогда не был местом назначения в Copy 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-description.

Этот заголовок не отображается, если этот большой двоичный объект никогда не был местом назначения в Copy Blob операции или если этот большой двоичный объект был изменен после завершения Copy Blob операции, в которой используются Set Blob Properties, Put Blob, или Put Block List.
x-ms-incremental-copy: true Версия 2016-05-31 и более поздних версий. Включается, если большой двоичный объект является добавочным копией.
x-ms-copy-destination-snapshot:<datetime> Версия 2016-05-31 и более поздних версий. Включается, если большой двоичный объект является большим двоичным объектом с добавочной копией или моментальным снимком добавочной копии, если x-ms-copy-status это успешное выполнение. Время моментального снимка последнего успешного добавочного снимка копирования для этого большого двоичного объекта.
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 в байтах. Для страничного BLOB-объекта этот заголовок возвращает значение x-ms-blob-content-length заголовка, хранящегося в BLOB-объекте.
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, это означает, что user-agent не должен отображать ответ, а вместо этого должен отображать диалоговое окно «Сохранить как».
Cache-Control Cache-Control Если заголовок запроса был ранее задан для большого двоичного объекта, это значение возвращается в этом заголовке.
x-ms-blob-sequence-number Текущий номер последовательности для большого двоичного объекта страницы.

Этот заголовок не возвращается для блочных или добавочных больших двоичных объектов.

Этот заголовок не возвращается для блочных BLOB-объектов.
x-ms-request-id Этот заголовок однозначно идентифицирует выполненный запрос, и его можно использовать для устранения неполадок запроса. Дополнительные сведения см. в разделе Устранение неполадок с операциями API.
x-ms-version Указывает версию хранилища BLOB-объектов, которая используется для выполнения запроса. Этот заголовок возвращается для запросов, выполненных в отношении версии 2009-09-19 и более поздних.

Этот заголовок также возвращается для анонимных запросов без указанной версии, если контейнер был помечен для общего доступа с помощью хранилища BLOB-объектов версии 2009-09-19.
Date Значение даты и времени в формате UTC, созданное службой, указывающее время начала ответа.
Accept-Ranges: bytes Указывает, что служба поддерживает запросы на частичное содержимое BLOB-объектов. Включено для запросов, сделанных с использованием версии 2013-08-15 и выше.
x-ms-blob-committed-block-count Число зафиксированных блоков, присутствующих в большом двоичном объекте. Этот заголовок возвращается только для больших двоичных объектов добавления.
x-ms-server-encrypted: true/false Версия 2015-12-11 и выше. Значение этого заголовка задается, если true данные BLOB-объекта и метаданные приложения полностью зашифрованы с использованием указанного алгоритма. В противном случае значение имеет значение ( 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 Версия 2017-04-17 и более поздних версий. Уровень страничного BLOB-объекта в учетной записи хранилища Premium или уровень блочного BLOB-объекта в хранилище BLOB-объектов или учетной записи общего назначения версии 2. Список разрешенных уровней BLOB-объектов страницы уровня "Премиум" см. в разделе высокопроизводительное хранилище класса Premium и управляемые диски для виртуальных машин. Для blob storage или общего назначения v2 допустимыми значениями являются Hot, Cool, Cold, Smart и Archive.
Примечание. УровеньCold поддерживается для версии 2021-12-02 и более поздних версий. Smart Tier поддерживается для версий 2026-02-06 и выше, сейчас находится в публичном предпросмотре.
Для подробной информации о стандартном уровне блока блобов в блобах см. Tiers хранения blob аккаунтов.
x-ms-access-tier-inferred: true Версия 2017-04-17 и более поздних версий. Только для страничных BLOB-объектов в учетной записи хранилища Premium. Если уровень доступа явно не задан для большого двоичного объекта, уровень определяется на основе длины его содержимого, и этот заголовок возвращается со значением true. Для блочных BLOB-объектов в Хранилище BLOB-объектов или учетной записи общего назначения версии 2, если для BLOB-объекта не задан уровень доступа, вы можете определить уровень из свойств учетной записи хранения. Этот заголовок задается только в том случае, если выводится уровень блочного BLOB-объекта.
x-ms-smart-access-tier Этот заголовок возвращается только для запросов, сделанных с версией 2026-02-06 и позже против blob в Smart уровне. Допустимые значения: Hot, Cool и Cold. Для подробной информации о стандартном уровне блока блобов в блобах см. Tiers хранения blob аккаунтов.
x-ms-archive-status Версия 2017-04-17 и более поздних версий. Для blob storage или общего назначения v2 аккаунта, если действительные значения равны rehydrate-pending-to-hot, rehydrate-pending-to-cool, и rehydrate-pending-to-cold. Если большой двоичный объект восстанавливается и не завершен, возвращается этот заголовок, который указывает на то, что восстановление находится на рассмотрении, и отображает целевой уровень. Для подробной информации о стандартном уровне блокирования блобов см. Tiers хранения blob аккаунтов.
x-ms-access-tier-change-time Версия 2017-04-17 и более поздних версий. Указывает время последнего изменения уровня на объекте. Этот заголовок возвращается только в том случае, если когда-либо был задан уровень в блочном большом двоичном объекте. Формат даты следует RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках. Для получения дополнительной информации о стандартном уровне уровня блокировки блобов в блобах см. Tiers хранения blob.
x-ms-client-request-id Можно использовать для устранения неполадок запросов и их соответствующих ответов. Значение этого заголовка равно значению x-ms-client-request-id заголовка, если он присутствует в запросе, и это значение составляет не более 1 024 видимых символов ASCII. Если в запросе отсутствует заголовок x-ms-client-request-id, этот заголовок отсутствует в ответе.
x-ms-rehydrate-priority Версия 2019-12-12 и выше. Если объект находится в состоянии ожидания повторного восстановления, этот заголовок возвращается с приоритетом повторного восстановления. Допустимые значения — High/Standard. Для подробной информации о стандартном уровне блока блобов в блобах см. Tiers хранения blob аккаунтов.
x-ms-or-{policy-id}_{rule-id} Версия 2019-12-12 и более поздние, возвращено только для блочных блобов. policy-id — это значение GUID, представляющее идентификатор политики репликации объектов в учетной записи хранения. rule-id — это значение GUID, представляющее идентификатор правила политики в контейнере BLOB-объектов. Если учетная запись включена ObjectReplication-enabled, значение этого заголовка представляет состояние репликации BLOB-объекта с заданными идентификаторами политики и правил, либо completefailed.
x-ms-or-policy-id Версия 2019-12-12 и более поздние, возвращено только для блочных блобов. Если учетная запись включена ObjectReplication-enabled, значение этого заголовка представляет политику, которая управляет репликацией.
x-ms-last-access-time Версия 2020-02-10 и выше. Указывает время последнего доступа к данным большого двоичного объекта в соответствии с политикой отслеживания времени последнего доступа учетной записи хранения. Заголовок не возвращается, если в учетной записи хранения отсутствует политика отслеживания времени последнего доступа или она отключена. Сведения о настройке политики отслеживания времени последнего доступа для учетной записи хранения см. в статье API хранилища BLOB-объектов.
x-ms-blob-sealed Версия 2019-12-12 и более поздние, возвращается только для добавленных больших двоичных объектов. Если добавочный большой двоичный объект был запечатан, значение будет истинным. Дополнительные сведения см. в разделе Добавление уплотнения BLOB-объекта
x-ms-immutability-policy-until-date Версия 2020-06-12 и выше. Указывает дату хранения до, заданную для большого двоичного объекта. Это дата, до которой большой двоичный объект может быть защищен от изменения или удаления. Возвращается только в том случае, если для большого двоичного объекта задана политика неизменяемости. Значение этого заголовка — RFC1123 формате.
x-ms-immutability-policy-mode: unlocked/locked Версия 2020-06-12 и выше. Режим политики неизменяемости, возвращаемый, если для большого двоичного объекта задана политика неизменяемости. Значения: unlocked/locked. unlocked Указывает, что пользователь может изменить политику, увеличив или уменьшив срок хранения до. locked указывает на то, что данные действия запрещены.
x-ms-legal-hold: true/false Версия 2020-06-12 и выше. Этот заголовок не возвращается, если на большой двоичный объект нет удержания по юридическим причинам. Для этого заголовка задано значение true , если большой двоичный объект содержит удержание по юридическим причинам и его значение равно true. В противном случае значение равно 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.
x-ms-expiry-time Версия 2020-02-10 и выше. Только для учетных записей с включенным иерархическим пространством имен. Возвращает время истечения срока действия, заданное для большого двоичного объекта. Возвращается только для файлов, для которых установлено время действия.

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

None.

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

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>

Authorization

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

Important

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

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

Remarks

Чтобы определить 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 , использующими более ранние версии, чем 2012-02-12.

x-ms-copy-status-description содержит дополнительную информацию о Copy Blob сбое. Значения x-ms-copy-status-description описаны в следующей таблице:

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

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

Important

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

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

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

Billing

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

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

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

См. также

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

  • Last updated on