Informazioni relative a tutte le registrazioni di un canale

  • Articolo

 

Recupera tutte le registrazioni relative a un canale, ad esempio ChannelUri, token di dispositivo, ID di registrazione di GCM.

Richiesta

Metodo URI della richiesta Versione HTTP
GET https://{Namespace}.ServiceBus.Windows.NET/{NotificationHub}/Registrations/?$Filter=ChannelUri eq '{channelUri} & api-version = 2015-01

oppure

https://{Namespace}.ServiceBus.Windows.NET/{NotificationHub}/Registrations/?$Filter=DeviceToken eq '{Tokendispositivo}' & api-version = 2015-01

oppure

https://{Namespace}.ServiceBus.Windows.NET/{NotificationHub}/Registrations/?$Filter=GcmRegistrationId eq '{Idregistrazionegcm}' & api-version = 2015-01		 HTTP/1.1

Tenere presente quanto segue:

  • Questa chiamata supporta il parametro di stringa di query $top specificato in OData.

  • Questa chiamata supporta un parametro di stringa di query ContinuationToken per continuare l'enumerazione.

  • ChannelUri è codificato come URL.

  • DeviceToken deve essere specificato nel formato esadecimale maiuscolo.

Intestazioni della richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Intestazione della richiesta Descrizione
Autorizzazione Token generato come specificato nell'autenticazione della firma di accesso condiviso con Bus di servizio oppure nell'autenticazione e nell'autorizzazione di Bus di servizio con Microsoft Azure Active Directory Access Control (anche noto come Servizio di controllo di accesso o ACS).
x-ms-version 2015-01

Corpo della richiesta

Nessuna.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codici di risposta

Codice Descrizione
200 Registrazioni recuperate.
400 Richiesta non valida. Gli hub notifiche non supportano questa query.
401 Errore di autorizzazione. Chiave di accesso non corretta.
403 Quota superata. Richiesta rifiutata perché la frequenza delle operazioni di registrazione è troppo elevata.

Per informazioni sui codici di stato, vedere Codici ed errori di stato.

Intestazioni della risposta

Intestazione della risposta Descrizione
Content-type application/atom+xml;type=entry;charset=utf-8
X-MS-ContinuationToken Contiene il token per continuare l'enumerazione delle registrazioni, nel caso in cui siano presenti più registrazioni.

Corpo della risposta

Feed Atom che racchiude l'elenco di registrazioni nel formato xml specificato in Create Registration, Ad esempio:

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