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

Настройка уровня BLOB-объектов

  • Статья

Операция Set Blob Tier задает уровень доступа для большого двоичного объекта. Операция разрешена на странице большого двоичного объекта в учетной записи хранения класса Premium и в блочных BLOB-объектах в хранилище BLOB-объектов или учетной записи общего назначения версии 2. Уровень большого двоичного объекта страницы класса Premium (P4/P6/P10/P15/P20/P30/P40/P50/P60) определяет допустимый размер, операции ввода-вывода в секунду и пропускную способность большого двоичного объекта. Уровень блочного BLOB-объекта определяет тип хранилища Hot/Cool/Cold/Archive. Эта операция не обновляет ETag большого двоичного объекта.

Подробные сведения о уровне блочного большого двоичного объекта см. в горячих, холодных и архивных уровнях хранилища.

Просьба

Можно создать запрос 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-объектов для задания уровня. Дополнительные сведения о работе с моментальными снимками BLOB-объектов см. в статье Создание моментального снимка большого двоичного объекта
versionid Необязательно для версии 2019-12-12 и более поздних версий. Параметр versionid является непрозрачным значением DateTime, которое при наличии указывает версию большого двоичного объекта для задания уровня.
timeout Необязательный. Параметр timeout выражается в секундах. Дополнительные сведения см. в разделе Настройка времени ожидания для операций хранилища BLOB-объектов.

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

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

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

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

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

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

Никакой.

Ответ

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

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

Успешная операция возвращает код состояния 200 (ОК), если новый уровень действует немедленно или код состояния 202 (принято), если переход на новый уровень ожидается.

Для учетных записей хранения класса Premium операция страничного BLOB-объекта возвращает код состояния 200 (ОК).

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

Ярус Установка уровня "Горячий" Установка уровня "Холодный" Задайте для холодного уровня Установка уровня архива
Большой двоичный объект на горячем уровне 200 200 200 200
Большой двоичный объект на холодном уровне 200 200 200 200
Большой двоичный объект в холодном уровне 200 200 200 200
Большой двоичный объект на уровне архива 202 202 202 200
Большой двоичный объект на уровне архива, повторное извлечение на горячий 202 409 409 409
Большой двоичный объект на уровне архива, повторное форматирование для охлаждения 409 202 409 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, он не будет присутствовать в ответе.

Авторизация

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

Важный

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

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

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

Разрешения

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

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

Замечания

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

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

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

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

Для больших двоичных объектов, использующих предоставленное клиентом шифрование, Set Blob Tier поддерживается для версии 2023-08-03 и более поздних версий. Для версий до 2023-08-03 Set Blob Tier возвращает код состояния 409 для больших двоичных объектов, использующих шифрование, предоставленное клиентом.

Заметка

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

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

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

Операция Тип учетной записи хранения Категория выставления счетов
Установка уровня BLOB-объектов (уровень вниз) Большой двоичный объект класса Premium
Стандартный общего назначения версии 2		 Операции записи
Настройка уровня BLOB-объектов (уровень вверх) Большой двоичный объект класса Premium
Стандартный общего назначения версии 2		 Операции чтения

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

См. также

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