Установка уровня большого двоичного объекта

Операция Set Blob Tier задает уровень доступа для большого двоичного объекта. Операция разрешена для страничного BLOB-объекта в учетной записи хранения класса Premium и в блочных BLOB-объектах в хранилище BLOB-объектов или учетной записи общего назначения версии 2. УровеньP1P3P4/P2// страничного BLOB-объекта (и т. д.) уровня "Премиум" определяет допустимый размер, число операций ввода-вывода в секунду и пропускную способность большого двоичного объекта. Уровень блочного BLOB-объекта определяет Hot//CoolArchive тип хранилища. Эта операция не обновляет ETag большого двоичного объекта.

Подробные сведения об уровне блочных BLOB-объектов см. в разделе "Горячий", "холодный" и "архивный" уровни хранилища.

Запрос

Запрос Set Blob Tier можно составить следующим образом. Рекомендуется использовать протокол HTTPS. Замените myaccount именем учетной записи хранения и myblob именем большого двоичного объекта, для которого необходимо изменить уровень.

Метод Универсальный код ресурса (URI) запроса Версия HTTP
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier HTTP/1.1

Параметры URI

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

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

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

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

Заголовок запроса Описание
Authorization Обязательный. Указывает схему авторизации, имя учетной записи хранения и подпись. Дополнительные сведения см. в статье "Авторизация запросов в службу хранилища Azure".
Date или x-ms-date Обязательный. Задает время запроса в формате UTC. Дополнительные сведения см. в статье "Авторизация запросов в службу хранилища Azure".
x-ms-access-tier Обязательный. Указывает уровень, который необходимо задать в большом двоичном объекте. Список разрешенных уровней страничных BLOB-объектов уровня "Премиум" см. в разделе "Высокопроизводительные хранилище класса Premium и управляемые диски для виртуальных машин". Для хранилища BLOB-объектов или учетной записи общего назначения версии 2 допустимые Hot//CoolArchiveзначения. Подробные сведения о уровне уровней blob-объектов стандартной учетной записи BLOB-объектов см. в разделе "Горячий", "холодный" и "архивный" уровни хранилища.
x-ms-version Требуется для всех авторизованных запросов. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в статье "Управление версиями" для служб хранилища Azure.
x-ms-client-request-id Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением на 1 кб символов, которое записывается в журналы аналитики при включении ведения журнала аналитики хранилища. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления операций на стороне клиента с запросами, которые получает сервер. Дополнительные сведения см. в статье о Аналитика Службы хранилища ведения журнала и ведения журнала Azure. Использование журналов для отслеживания запросов на хранение.
x-ms-rehydrate-priority Необязательный элемент. Указывает приоритет, с помощью которого необходимо восстановить архивный BLOB-объект. Поддерживается в версии 2019-02-02 и более поздних версиях для блочных BLOB-объектов. Допустимые High/Standardзначения: . Приоритет можно задать только один раз для больших двоичных объектов для версий до 2020-06-12; этот заголовок будет игнорироваться при последующих запросах. Параметр приоритета по умолчанию — Standard.

Начиная с версии 2020-06-12 приоритет восстановления можно обновить после установки ранее. Параметр приоритета можно изменить с StandardHigh помощью вызова set Blob Tier с этим заголовком High и установить x-ms-access-tier значение того же значения, что и ранее задано. Параметр приоритета не может быть понижен от High .Standard

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

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

Отсутствует.

Ответ

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

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

Успешная операция возвращает код состояния 200 (ОК), если новый уровень вступает в силу немедленно, или код состояния 202 (принято), если переход на новый уровень ожидается. Для операции страничного BLOB-объекта учетной записи premium возвращается код состояния 200 (ОК). Для блочных BLOB-объектов в следующей таблице описываются коды состояния HTTP, возвращаемые на основе текущего уровня и запрошенного уровня большого двоичного объекта:

Уровень Установка уровня "Горячий" Установка уровня "Холодный" Установка уровня архива
Большой двоичный объект на горячем уровне 200 200 200
Большой двоичный объект на холодном уровне 200 200 200
Большой двоичный объект на уровне архива 202 202 200
Большой двоичный объект на уровне архива, перерисовка на горячий 202 409 409
Большой двоичный объект на архивном уровне, повторное форматирование для охлаждения 409 202 409

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

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

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

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

Авторизация

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

Remarks

Настройка уровня BLOB-объекта для страничных BLOB-объектов в учетных записях уровня "Премиум" имеет следующие ограничения:

Установка уровня блочного BLOB-объекта в хранилище BLOB-объектов или учетной записи общего назначения версии 2 имеет следующие ограничения:

  • Уровень параметров моментального снимка разрешен начиная с REST версии 2019-12-12.
  • Моментальные снимки, многоуровневые для архивации, нельзя восстановить обратно в моментальный снимок. Т.е. моментальный снимок нельзя вернуть на горячий или холодный уровень. Единственный способ получить данные из архивного моментального снимка или версии — скопировать их в новый большой двоичный объект.
  • Если версия является корневым BLOB-объектом, то ее можно восстановить обратно в горячий или холодный.
  • Моментальные снимки или версии в архивном состоянии нельзя повысить до корневого уровня.
  • Если управление версиями включено, удаление корневого большого двоичного объекта при ожидании восстановления приведет к отмене восстановления, а версия будет находиться в архивном состоянии.
  • Если большой двоичный объект перезаписывается в состоянии ожидания восстановления и обратимого состояния, это приведет к отмене восстановления, а версия или обратимый моментальный снимок будет находиться в архивном состоянии.

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

Примечание

Подробные сведения о многоуровневом уровне блочных BLOB-объектов см. в разделе "Горячий", "холодный" и "архивный" уровни хранилища.

См. также:

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