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

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

Обновлено: Январь 2014 г.

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

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

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

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

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

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

 

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

Контейнеры списков (REST API)

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

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

Set Blob Service Properties (REST API)

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

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

Get Blob Service Properties (REST API)

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

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

Preflight Blob Request

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

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

Получение статистики службы больших двоичных объектов (API-интерфейс REST)

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

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

Создание контейнера (REST API)

Контейнер

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

Получение свойств контейнера (REST API)

Контейнер

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

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

Контейнер

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

Set Container Metadata (REST API)

Контейнер

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

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

Контейнер

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

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

Контейнер

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

Аренда контейнера (REST API)

Контейнер

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

Удаление контейнера (REST API)

Контейнер

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

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

Контейнер

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

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

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

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

Get Blob (REST API)

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

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

Get Blob Properties (REST API)

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

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

Set Blob Properties (REST API)

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

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

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

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

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

Задание метаданных BLOB-объектов (REST API)

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

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

Delete Blob (REST API)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Put Block (REST API)

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

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

Вставка списка блокировок (REST API)

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

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

Получение списка блокировок (REST API)

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

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

Put Page (REST API)

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

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

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

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

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

noteПримечание
Доступ к BLOB-объектам также возможен через типы в пространстве имен Microsoft.WindowsAzure.StorageClient SDK Windows Azure для .NET.

См. также

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