Lesen aller Registrierungen eines Kanals

  • Artikel

 

Veröffentlicht: Februar 2016

Ruft alle Registrierungen für einen Kanal ab (z. B. ChannelUri, Gerätetoken, GCM-registrationId).

Anforderung

Methode Anforderungs-URI HTTP-Version
GET https://{Namespace}.Servicebus.Windows.NET/{NotificationHub}/Registrations/?$Filter=ChannelUri-Eq '{Kanal-URI}' & api-Version = 2015-01

- oder -

https://{Namespace}.Servicebus.Windows.NET/{NotificationHub}/Registrations/?$Filter=DeviceToken Eq "{Gerätetoken}" & api-Version = 2015-01

- oder -

https://{Namespace}.Servicebus.Windows.NET/{NotificationHub}/Registrations/?$Filter=GcmRegistrationId-Eq '{GcmRegistrationId}' & api-Version = 2015-01		 HTTP/1.1

Beachten Sie Folgendes:

  • Dieser Aufruf unterstützt den Abfragezeichenfolgen-Parameter $top wie in OData angegeben.

  • Dieser Aufruf unterstützt eine ContinuationToken Abfragezeichenfolgenparameter Fortsetzung die Enumeration.

  • ChannelUri Url-codiert ist.

  • DeviceToken in Großbuchstaben hexadezimalen Format vorliegen muss.

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader Beschreibung
Autorisierung Gemäß der Shared Access Signature Authentifizierung mit generierte Token Servicebus, oder Servicebus Authentifizierung und Autorisierung über Zugriffssteuerung für Microsoft Azure Active Directory (auch Zugriffssteuerungsdienst oder ACS).
x-ms-version 2015-01

Anforderungstext

Keine.

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Antwortcodes

Code Beschreibung
200 Die Registrierungen wurden erfolgreich abgerufen.
400 Ungültige Anforderung. Benachrichtigungshubs unterstützen diese Abfrage nicht.
401 Autorisierungsfehler Der Zugriffsschlüssel war falsch.
403 Das Kontingent wurde überschritten. Die Anforderung wurde zurückgewiesen, weil die Registrierungsvorgangsrate zu hoch ist.

Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortheader

Antwortheader Beschreibung
Content-type application/atom+xml;type=entry;charset=utf-8
X-MS-ContinuationToken Enthält das Token zur Fortsetzung der Enumeration der Registrierungen, falls weitere vorhanden sind.

Antworttext

Atom-feed, der die Liste der Registrierungen im Xml-Format im angegebenen umschließt Create Registration. Beispiel:

<?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>