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


Адресация ресурсов службы очередей

Служба очередей предоставляет следующие ресурсы через API-интерфейс REST:

  • "Учетная запись". Учетная запись хранения — это уникально идентифицируемая сущность в системе хранения данных. Учетная запись является родительским пространством имен для службы очередей. Все очереди связаны с учетной записью.

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

  • Сообщения. Текст сообщений кодирован в UTF-8 и может быть значением XML-элемента. Размер сообщения может быть 64 КиБ.

Синтаксис URI ресурса

Каждый ресурс имеет соответствующий базовый URI-адрес, который ссылается на сам ресурс.

Для учетной записи хранилища базовый URI для операций с очередями включает только имя учетной записи:

https://myaccount.queue.core.windows.net  

Для очереди базовый URI-адрес включает имя учетной записи и имя очереди:

https://myaccount.queue.core.windows.net/myqueue  

Для сообщений в очереди базовый URI включает имя учетной записи, имя очереди и набор сообщений в этой очереди:

https://myaccount.queue.core.windows.net/myqueue/messages  

Отдельное сообщение можно обновить или удалить по ссылке на идентификатор сообщения. Обратите внимание, что этот синтаксис доступен только для операций "Обновить сообщение" и "Удалить сообщение" и требует наличия popreceipt параметра для проверки:

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value  

Каждый ресурс может также иметь компоненты, выраженные как части строки запроса в базовом URI. Синтаксис строки запроса следующий: ?comp=<component_name>. В настоящее время имеются следующие компоненты ресурсов, доступные для ресурсов очереди как параметры в URI.

Компонент Поддерживаемые ресурсы Описание
list Учетная запись Перечисляет сущности в данном ресурсе. В учетной записи возвращает список очередей.
metadata Очередь Задает или возвращает свойства очереди, включая определяемые пользователем метаданные.

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

Поддерживаемые операции HTTP

Каждый ресурс поддерживает операции, основанные на HTTP-командах GET, PUT, HEAD и DELETE. Команда, синтаксис и поддерживаемые версии HTTP для каждой из операций приведены на странице со справкой по соответствующей операции. Полный список справочных страниц операций см. в разделе REST API службы очередей.

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

Именование очередей и метаданных
Операции в очередях
Операции с сообщениями
REST API службы очередей