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


Чтение всех регистраций с тегом

 

Извлекает все регистрации с определенным тегом.

Запрос

Метод URI запроса Версия HTTP
GET https://{namespace}.servicebus.Windows.NET/{NotificationHub}/Tags/{Tag}/registrations?API-Version=2015-01 HTTP/1.1

Обратите внимание на следующие моменты.

  • Этот вызов поддерживает параметр строки запросов $top, как того требует протокол OData.

  • Этот вызов поддерживает ContinuationToken запрос строковый параметр для продолжения перечисления.

Заголовки запроса

В следующей таблице перечислены обязательные и необязательные заголовки запросов.

Заголовок запроса Описание
Авторизация Маркер создается, как указано в общий доступ подпись проверки подлинности с Служебная шина, или Служебная шина проверки подлинности и авторизации с помощью Microsoft Azure Active Directory Access Control (также называется Access Control Service или ACS).
x-ms-version 2015-01

Текст запроса

Отсутствует.

Ответ

Ответ включает код состояния HTTP и набор заголовков ответа.

Коды ответа

код Описание
200 Регистрации успешно извлечены.
401 Ошибка авторизации. Неверный ключ доступа.
404 Не найден. Хэш канала не существует.
403 Превышена квота. Запрос отклонен, поскольку частота выполнения операций регистрации слишком высока.

Сведения о кодах состояния см. в разделе коды состояний и ошибок.

Заголовки ответа

Заголовок ответа Описание
Тип содержимого application/atom+xml;type=entry;charset=utf-8

Текст ответа

Веб-канал Atom, который создает оболочку для списка регистраций в формате xml, указанный в Create Registration. Например:

<?xml version="1.0" encoding="utf-8" ?> <feed xmlns="http://www.w3.org/2005/Atom"> <title type="/{NotificationTopic}/channels/{channel hash}" /> <id> https://{tenant}.windows.net/{NotificationTopic}/channels/{channel hash}</id> <updated>2012-08-17T17:32:00Z</updated> <entry xmlns:m=”https://schemas.microsoft.com/ado/2007/08/dataservices/metadata” m:etag=”W/"1234567890"”> <id>https://{tenant}.windows.net/{NotificationTopic}/registrations/{registrationId}</id> <title type="text"> /{NotificationTopic}/registrations/{registrationId}</title> <updated>2012-08-17T17:32:00Z</updated> <content type="application/xml"> <WindowsRegistrationDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://schemas.microsoft.com/netservices/2010/10/servicebus/connect"> <ETag>{ETag}</ETag> <ExpirationTime>2012-07-16T19:20+01:00</ExpirationTime> <RegistrationId>{RegistrationId}</RegistrationId> <Tags>myTag, myOtherTag</Tags> <ChannelUri>{ChannelUri}</ChannelUri> </WindowsRegistrationDescription> </content> </entry> <entry> … </entry> </feed>