REST API хранилища BLOB-объектов Azure
Хранилище BLOB-объектов Azure хранит текстовые и двоичные данные в виде объектов в облаке. Хранилище BLOB-объектов предлагает следующие ресурсы: учетную запись хранения, контейнеры и BLOB-объекты. В рамках учетной записи хранилища контейнеры предоставляют способ упорядочения наборов BLOB-объектов.
Можно хранить текст и двоичные данные в BLOB-объектах одного из следующих типов:
Блочные BLOB-объекты, оптимизированные для потоков.
Добавочные BLOB-объекты, оптимизированные для операций добавления.
Страничные BLOB-объекты, оптимизированные для случайных операций чтения и записи и обеспечивающие возможность записи в диапазон байтов в большом двоичном объекте.
Дополнительные сведения см. в статье Основные сведения о блочных, добавочных и страничных BLOB-объектах.
REST API для хранилища BLOB-объектов определяет операции HTTP для учетной записи хранения, контейнеров и BLOB-объектов. Этот API-интерфейс включает операции, перечисленные в следующей таблице.
| Операция | Тип ресурса | Описание |
|---|---|---|
| Получение списка контейнеров | Учетная запись | Перечисляет все контейнеры в учетной записи хранилища. |
| Настройка свойств хранилища BLOB-объектов | Учетная запись | Задает свойства хранилища BLOB-объектов, включая параметры ведения журнала и метрик, а также версию службы по умолчанию. |
| Получение свойств хранилища BLOB-объектов | Учетная запись | Возвращает свойства Хранилища BLOB-объектов, включая параметры ведения журнала и метрик, а также версию службы по умолчанию. |
| Предварительный запрос BLOB-объекта | Учетная запись | Запрашивает правила общего доступа к ресурсам независимо от источника (CORS) для Хранилища BLOB-объектов перед отправкой фактического запроса. |
| Получение статистики хранилища BLOB-объектов | Учетная запись | Извлекает статистику, связанную с репликацией хранилища BLOB-объектов. Эта операция доступна только для вторичной конечной точки, если для учетной записи хранилища включена географически избыточная репликация с доступом для чтения. |
| Получение сведений об учетной записи | Учетная запись | Возвращает имя SKU и тип учетной записи для указанной учетной записи. |
| Получение ключа делегирования пользователя | Учетная запись | Возвращает ключ, который можно использовать для подписи подписанного URL-адреса делегирования пользователей. Эта подпись предоставляет доступ к ресурсам в хранилище BLOB-объектов с помощью Microsoft Entra учетных данных. |
| Create Container (Создание контейнера) | Контейнер | Создание контейнера в учетной записи хранения. |
| Получение свойств контейнера | Контейнер | Возвращает все определяемые пользователем метаданные и системные свойства контейнера. |
| Get Container Metadata (Получение метаданных контейнера) | Контейнер | Возвращает только определяемые пользователем метаданные контейнера. |
| Настройка метаданных контейнера | Контейнер | Устанавливает определяемые пользователем метаданные контейнера. |
| Get Container ACL (Получение списка управления доступом для контейнера) | Контейнер | Возвращает политику открытого доступа и все хранимые политики доступа для контейнера. |
| Set Container ACL | Контейнер | Устанавливает политику открытого доступа и все хранимые политики доступа для контейнера. |
| Аренда контейнера | Контейнер | Устанавливает блокировку контейнера для операций удаления и управляет этой блокировкой. |
| Delete Container (Удаление контейнера) | Контейнер | Удаляет контейнер и все BLOB-объекты, которые он содержит. |
| Перечисление больших двоичных объектов | Контейнер | Перечисляет все BLOB-объекты в контейнере. |
| Put BLOB (Вставка BLOB-объекта) | Блочные, добавочные и страничные BLOB-объекты | Создает новый большой двоичный объект или заменяет существующий большой двоичный объект в контейнере. |
| Get BLOB (Получение BLOB-объекта) | Блочные, добавочные и страничные BLOB-объекты | Считывает или скачивает BLOB-объект из хранилища BLOB-объектов, включая его определяемые пользователем метаданные и системные свойства. |
| Получение свойств большого двоичного объекта | Блочные, добавочные и страничные BLOB-объекты | Возвращает все системные свойства и определяемые пользователем метаданные BLOB-объекта. |
| Set BLOB Properties (Задание свойств службы BLOB-объекта) | Блочные, добавочные и страничные BLOB-объекты | Устанавливает системные свойства, определенные для существующего BLOB-объекта. |
| Установка срока действия BLOB-объекта | Blob-блоки | Задает время истечения срока действия для существующего BLOB-объекта. |
| Get BLOB Metadata (Получение метаданных BLOB-объекта) | Блочные, добавочные и страничные BLOB-объекты | Получает все определяемые пользователем метаданные существующего BLOB-объекта или моментального снимка. |
| Set BLOB Metadata (Задание метаданных BLOB-объекта) | Блочные, добавочные и страничные BLOB-объекты | Устанавливает определяемые пользователем метаданные существующего BLOB-объекта. |
| Получение тегов BLOB-объектов | Блочные, добавочные и страничные BLOB-объекты | Извлекает определяемые пользователем теги существующего большого двоичного объекта. |
| Установка тегов BLOB-объектов | Блочные, добавочные и страничные BLOB-объекты | Задает определяемые пользователем теги существующего большого двоичного объекта, образующие вторичный индекс. |
| Поиск BLOB-объектов по тегам | Блочные, добавочные и страничные BLOB-объекты | Списки BLOB-объекты по пользовательским тегам. |
| Удаление BLOB-объекта | Блочные, добавочные и страничные BLOB-объекты | Отмечает BLOB-объект для удаления. |
| Отмена удаления большого двоичного объекта | Блочные, добавочные и страничные BLOB-объекты | Восстанавливает содержимое и метаданные обратимо удаленного BLOB-объекта или всех связанных обратимо удаленных моментальных снимков. |
| Lease Blob (Аренда большого двоичного объекта) | Блочные, добавочные и страничные BLOB-объекты | Устанавливает блокировку на операции записи и удаления и управляет ею. Чтобы удалить заблокированный большой двоичный объект или записать что-либо в него, клиент должен использовать идентификатор аренды. |
| Создание моментального снимка большого двоичного объекта | Блочные, добавочные и страничные BLOB-объекты | Создает доступный только для чтения моментальный снимок BLOB-объекта. |
| Копирование BLOB-объекта | Блочные, добавочные и страничные BLOB-объекты | Копирует BLOB-объект источника в BLOB-объект назначения в этой или другой учетной записи хранилища. |
| Прерывание копирования большого двоичного объекта | Блочные, добавочные и страничные BLOB-объекты | Останавливает отложенную Copy Blob операцию и оставляет целевой BLOB-объект с нулевой длиной и полными метаданными. |
| Put Block (Вставка блокировки) | Только блочные BLOB-объекты | Создает новую блокировку, которая фиксируется как часть блочного BLOB-объекта. |
| Вставка блока из URL-адреса | Только блочные BLOB-объекты | Создает новый блок для фиксации в составе блочного BLOB-объекта, в котором содержимое считывается из URL-адреса. |
| Put Block List (Вставка списка блокировки) | Только блочные BLOB-объекты | Фиксирует большой двоичный объект путем указания набора идентификаторов блокировок, представляющих блочный BLOB-объект. |
| Get Block List (Получение списка блокировки) | Только блочные BLOB-объекты | Извлекает список блокировок, которые были загружены как часть блочного большого двоичного объекта. |
| Запрос содержимого BLOB-объекта | Только блочные BLOB-объекты | Применяет простую инструкцию язык SQL (SQL) к содержимому BLOB-объекта и возвращает только запрашиваемое подмножество данных. |
| Установка уровня большого двоичного объекта | Блочные и страничные BLOB-объекты | Задает уровень большого двоичного объекта. |
| Put Page | Только страничные BLOB-объекты | Записывает диапазон страниц в страничный BLOB-объект. |
| Get Page Ranges (получение диапазона страницы); | Только страничные BLOB-объекты | Возвращает список диапазонов действительных страниц для страничного BLOB-объекта или моментальных снимков для страничного BLOB-объекта. |
| Incremental Copy Blob (инкрементная копия Blob); | Только страничные BLOB-объекты | Копирует snapshot исходного страничного BLOB-объекта в целевой страничный BLOB-объект. Передаются только разностные изменения. |
| Append Block | Только BLOB-объекты с дополнением | Записывает блок данных в конец добавочного BLOB-объекта. |
В этом разделе
Основные понятия хранилища BLOB-объектов
Операции с учетной записью (хранилище BLOB-объектов)
Операции с большими двоичными объектами