Адресация ресурсов службы очередей
Служба очередей предоставляет следующие ресурсы через 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 службы очередей