Продажи: 1-800-867-1389

API-интерфейс REST службы BLOB-объектов

Обновлено: Май 2015 г.

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

Можно хранить текст и двоичные данные в BLOB-объектах одного из следующих типов:

  • Блочные BLOB-объекты, оптимизированные для потоков.

  • BLOB-объекты с дополнением, которые оптимизированы для операций добавления

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

Дополнительные сведения о блочных и страничных BLOB-объектах см. в разделе Основные сведения о блочных, добавочных и страничных BLOB-объектах.

API REST для службы BLOB-объектов определяет операции HTTP в контейнере и BLOB-ресурсах. Этот API-интерфейс включает операции, перечисленные в следующей таблице.

 

Операция Тип ресурса Описание

Контейнеры списков

Учетная запись

Перечисляет все контейнеры в учетной записи хранилища.

Задание свойств службы BLOB-объектов

Учетная запись

Устанавливает свойства службы BLOB-объектов, в том числе параметры ведения журнала и метрик и версию службы по умолчанию.

Получение свойств службы BLOB-объектов

Учетная запись

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

Предварительный запрос большого двоичного объекта

Учетная запись

Запрашивает правила общего доступа к ресурсам независимо от источника (CORS) для службы BLOB-объектов перед отправкой самого запроса.

Получение статистики службы больших двоичных объектов

Учетная запись

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

Создание контейнера

Контейнер

Создает новый контейнер в учетной записи хранилища.

Получение свойств контейнера

Контейнер

Возвращает все определяемые пользователем метаданные и системные свойства контейнера.

Получение метаданных контейнера

Контейнер

Возвращает только определяемые пользователем метаданные контейнера.

Задание метаданных контейнера

Контейнер

Устанавливает определяемые пользователем метаданные контейнера.

Получение списка управления доступом для контейнера

Контейнер

Возвращает политику открытого доступа и все хранимые политики доступа для контейнера.

Задание списка управления доступом для контейнера

Контейнер

Устанавливает политику открытого доступа и все хранимые политики доступа для контейнера.

Аренда контейнера

Контейнер

Устанавливает блокировку контейнера для операций удаления и управляет этой блокировкой.

Удалить контейнер

Контейнер

Удаляет контейнер и все BLOB-объекты, которые он содержит.

Перечисление больших двоичных объектов

Контейнер

Перечисляет все BLOB-объекты в контейнере.

Вставка большого двоичного объекта

Блочные, страничные BLOB-объекты и BLOB-объекты с дополнением

Создает новый большой двоичный объект или заменяет существующий большой двоичный объект в контейнере.

Получение большого двоичного объекта

Блочные, страничные BLOB-объекты и BLOB-объекты с дополнением

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

Получение свойств больших двоичных объектов

Блочные, страничные BLOB-объекты и BLOB-объекты с дополнением

Возвращает все системные свойства и определяемые пользователем метаданные BLOB-объекта.

Задание свойств больших двоичных объектов

Блочные, страничные BLOB-объекты и BLOB-объекты с дополнением

Устанавливает системные свойства, определенные для существующего BLOB-объекта.

Получение метаданных BLOB-объектов

Блочные, страничные BLOB-объекты и BLOB-объекты с дополнением

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

Задание метаданных больших двоичных объектов

Блочные, страничные BLOB-объекты и BLOB-объекты с дополнением

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

Удаление больших двоичных объектов

Блочные, страничные BLOB-объекты и BLOB-объекты с дополнением

Отмечает BLOB-объект для удаления.

Аренда больших двоичных объектов

Блочные, страничные BLOB-объекты и BLOB-объекты с дополнением

Устанавливает блокировку на операции записи и удаления и управляет ею. Чтобы удалить заблокированный большой двоичный объект или записать что-либо в него, клиент должен использовать идентификатор аренды.

Моментальные снимки больших двоичных объектов

Блочные, страничные BLOB-объекты и BLOB-объекты с дополнением

Создает доступный только для чтения моментальный снимок BLOB-объекта.

Копирование большого двоичного объекта

Блочные, страничные BLOB-объекты и BLOB-объекты с дополнением

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

Прерывание копирования BLOB-объекта

Блочные, страничные BLOB-объекты и BLOB-объекты с дополнением

Прерывает ждущую операцию Copy Blob, оставляя целевой большой двоичный объект с нулевой длиной и полными метаданными.

Вставка блокировки

Только блочные BLOB-объекты

Создает новую блокировку, которую нужно зафиксировать как часть блочного большого двоичного объекта.

Вставка списка блокировок

Только блочные BLOB-объекты

Фиксирует BLOB-объект, указывая набор идентификаторов блокировки, представляющих BLOB-объект.

Получение списка блокировок

Только блочные BLOB-объекты

Извлекает список блокировок, которые были загружены как часть блочного большого двоичного объекта.

Вставка страницы

Только страничные BLOB-объекты

Записывает диапазон страниц в страничный BLOB-объект.

Append Block

Только BLOB-объекты с дополнением

Добавляет блок данных в конец BLOB-объекта с дополнением.

Получение диапазонов страниц

Только страничные BLOB-объекты

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

См. также

Была ли вам полезна эта информация?
(1500 символов осталось)
Спасибо за ваш отзыв
Показ:
© 2015 Microsoft