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

  • Статья

Операция 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-объектов см. в разделе Создание 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-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 Версия 2017-11-09 и более поздние версии. Дата и время создания большого двоичного объекта. Дата в формате согласно RFC 1123.
x-ms-meta-name:value Набор пар "имя-значение", связанных с этим BLOB-объектом в качестве определяемых пользователем метаданных.
x-ms-tag-count Версия 2019-12-12 и более поздние версии. Если большой двоичный объект содержит теги, этот заголовок возвращает количество тегов, хранящихся в большом двоичном объекте. Заголовок не возвращается, если в большом двоичном объекте нет тегов.
Content-Length Число байтов в тексте ответа.
Content-Type Тип контента, указанный для большого двоичного объекта. Тип содержимого по умолчанию — application/octet-stream.
Content-Range Указывает диапазон байтов, возвращаемых в случае, если клиент запросил подмножество большого двоичного объекта, задав Range заголовок запроса.
ETag Содержит значение, которое можно использовать для условного выполнения операций. Дополнительные сведения см. в разделе Указание условных заголовков для операций с хранилищем BLOB-объектов. Если версия запроса — 2011-08-18 или более поздняя, значение 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-объектов.
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. Описывает причину последнего неустранимого или устранимого сбоя операции копирования. Этот заголовок не отображается, если этот BLOB-объект никогда не был назначением 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 байтов, скопированных. Этот заголовок не отображается, если этот BLOB-объект никогда не был назначением 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-объектом. Этот заголовок не отображается, если этот 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.

Этот заголовок не отображается, если этот BLOB-объект никогда не был назначением 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 Версия 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 и более поздняя. Этот заголовок не возвращается, если большой двоичный объект не удерживается по закону. Если большой двоичный объект содержит удержание по юридическим причинам, то значение этого заголовка равно 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-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 как описано ниже.

Служба хранилища 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 см. в статье Назначение роли Azure для доступа к данным BLOB-объектов.

Комментарии

Для страничного большого двоичного объекта операция 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-объектов