Экспорт (0) Печать
Развернуть все

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

Обновлено: Ноябрь 2014 г.

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

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

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

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

Дополнительные сведения о блочных и страничных BLOB-объектах см. в разделе Understanding Block Blobs and Page Blobs.

API-интерфейс REST для службы BLOB-объектов предоставляет способ работать с ресурсами контейнеров и BLOB-объектов посредством HTTP-операций. Этот 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-объекты

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также

Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2014 Microsoft