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


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-объектов)

Операции в контейнерах

Операции с большими двоичными объектами

Операции с большими двоичными объектами (иерархические учетные записи с поддержкой пространства имен)

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

REST служб хранилища