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

Статья
02/03/2024

Операция Set Blob Tier задает уровень доступа для большого двоичного объекта. Операция разрешена для страничного BLOB-объекта в учетной записи хранения класса Premium и блочного BLOB-объекта в хранилище BLOB-объектов или учетной записи общего назначения версии 2. Уровень страничного BLOB-объекта (P4/P15//P30P40/P50///P60P6P10/P20) () определяет допустимый размер, операции ввода-вывода в секунду и пропускную способность большого двоичного объекта. Уровень блочного BLOB-объекта определяет HotColdArchive/Cool//тип хранилища. Эта операция не обновляет 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`	Необязательный элемент. Параметр snapshot является непрозрачным `DateTime` значением, которое при его наличии указывает snapshot большого двоичного объекта для установки уровня. Дополнительные сведения о работе с моментальными снимками BLOB-объектов см. в статье Создание snapshot большого двоичного объекта.
`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` tier поддерживается для версии 2021-12-02 и более поздних версий. Подробные сведения о уровне хранилища учетных записей BLOB-объектов категории "Стандартный" см. в статье Горячий, холодный и архивный уровни хранилища.
`x-ms-version`	Требуется для всех авторизованных запросов. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в статье Управление версиями для служб хранилища Azure.
`x-ms-client-request-id`	Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 КБ символов, которое записывается в журналы аналитики при включении ведения журнала аналитики хранилища. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления операций на стороне клиента с запросами, которые получает сервер. Дополнительные сведения см. в разделе Сведения о ведении журнала Аналитика Службы хранилища.
`x-ms-rehydrate-priority`	Необязательный элемент. Указывает приоритет восстановления архивного большого двоичного объекта. Поддерживается в версии 2019-02-02 и более поздних для блочных BLOB-объектов. Допустимые значения: `High`/`Standard`. Для версий, предшествующих 12.06.2020, приоритет можно задать для большого двоичного объекта только один раз; этот заголовок будет игнорироваться при последующих запросах. Приоритет по умолчанию — `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
BLOB-объект на холодном уровне	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 как описано ниже.

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

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

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

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

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

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

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

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

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

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

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

SAS для службы

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

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

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

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

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

Операция	Подписанная служба	Подписанный тип ресурса	Подписанное разрешение
Установка уровня большого двоичного объекта	Большой двоичный объект (b)	Объект (o)	Запись (w)

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

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

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

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

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

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

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

Примечание

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

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

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

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

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

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