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


REST API хранилища очередей

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

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

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

REST API для хранилища очередей включает следующие операции:

Операция Описание
Задание свойств службы очередей Задает свойства хранилища очередей.
Получение свойств службы очередей Возвращает свойства хранилища очередей.
Перечисление очередей Выводит список всех очередей в учетной записи.
Предварительный запрос очереди Запрашивает правила общего доступа к ресурсам независимо от источника (CORS) для хранилища очередей перед отправкой запроса.
Получение статистики службы очередей Извлекает статистику, связанную с репликацией для хранилища очередей. Эта операция доступна только в конечной точке дополнительного расположения, если для учетной записи хранения включена геоизбыточная репликация с доступом на чтение.
Создать очередь Создает новую очередь в учетной записи.
Удаление очереди. Удаляет очередь.
Получение метаданных очереди Возвращает свойства очереди, включая определяемые пользователем метаданные.
Настройка метаданных очереди Задает определяемые пользователем метаданные для очереди.
Получение списка управления доступом очереди Возвращает сведения обо всех хранимых политиках доступа, заданных для очереди.
Задание списков управления доступом для очередей Задает хранимые политики доступа для очереди, которые можно использовать с подписанными URL-адресами.
Сообщение Put Добавляет сообщение в очередь и при необходимости задает время ожидания видимости для сообщения.
Получение сообщений Получает сообщение из очереди и делает его невидимым для других потребителей.
Извлечение сообщений Получает сообщение из начала очереди, не меняя его видимость.
Удалить сообщение Удаляет указанное сообщение из очереди.
Очистить сообщения Очищает все сообщения в очереди.
Обновление сообщения Обновления время ожидания видимости сообщения и (или) содержимого сообщения.

В этом разделе

Основные понятия службы "Хранилища очередей"
Операции с очередями
Операции с сообщениями

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

Справочник по API-интерфейсу REST служб хранилища