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

API-интерфейс REST для службы очередей

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

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

Очередь может содержать неограниченное число сообщений, каждое размером до 64 КБ при использовании версии 2011-08-18 или более новой. Для предыдущих версий максимальный размер сообщения составлял 8 КБ. Сообщения обычно добавляются к концу очереди и извлекаются из ее начала, хотя поведение FIFO («первым пришел, первым ушел») не гарантируется.

Если необходимо хранить сообщения размером более 64 КБ, то данные сообщений можно хранить как BLOB-объекты или в таблице, а в виде сообщений очереди сохранять ссылки на эти данные.

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

 

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

Задание свойств службы очередей

Задает свойства службы очередей.

Получение свойств службы очередей

Возвращает свойства службы очередей.

Очереди списков

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

Предварительный запрос очереди

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

Получение статистики службы очередей

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

Создание очереди

Создает новую очередь в данной учетной записи.

Удаление очереди (API-интерфейс REST)

Удаляет очередь.

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

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

Задание метаданных очереди (API-интерфейс REST)

Задает определяемые пользователем метаданные для очереди.

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

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

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

Задает хранимые политики доступа для очереди, которая может быть использована с подписями коллективного доступа.

Сообщение Put

Добавляет сообщение в очередь и при необходимости устанавливает время видимости для сообщения.

Получение сообщений

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

Извлечение сообщений

Получает сообщение из начала очереди, не меняя его видимость.

Удаление сообщения

Удаляет указанное сообщение из очереди.

Очистка сообщений (API-интерфейс REST)

Очищает все сообщения в очереди.

Обновление сообщений

Обновляет время видимости сообщения или содержимое сообщения.

См. также

Показ:
© 2015 Microsoft