Чтение всех регистраций канала

Статья
11/18/2016

Извлекает все регистрации для канала (например, идентификатор ChannelUri, маркер устройства, параметр registrationId службы GCM).

Запрос

Метод	URI запроса	Версия HTTP
GET	https://{namespace}.servicebus.Windows.NET/{NotificationHub}/registrations/?$Filter=ChannelUri eq '{channelUri} & api-version = 01 2015 г. или https://{namespace}.servicebus.Windows.NET/{NotificationHub}/registrations/?$Filter=DeviceToken eq '{deviceToken} & api-version = 01 2015 г. или https://{namespace}.servicebus.Windows.NET/{NotificationHub}/registrations/?$Filter=GcmRegistrationId eq '{gcmRegistrationId} & api-version = 01 2015 г.	HTTP/1.1

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

Этот вызов поддерживает параметр строки запросов $top, как того требует протокол OData.
Этот вызов поддерживает ContinuationToken запрос строковый параметр для продолжения перечисления.
ChannelUri кодирование URL-адрес.
DeviceToken должно быть в верхнем регистре шестнадцатеричный формат.

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

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

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

Авторизация

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

x-ms-version

2015-01

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

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

Ответ

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

Коды ответа

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

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

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

Заголовок ответа	Описание
Тип содержимого	application/atom+xml;type=entry;charset=utf-8
X-MS-ContinuationToken	Содержит маркер для продолжения перечисления регистраций, если имеются дополнительные регистрации.

Текст ответа

Веб-канал 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>

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