Lettura di tutte le registrazioni
Recupera tutte le registrazioni.
Richiesta
Metodo | URI della richiesta | Versione HTTP |
---|---|---|
GET | https://{Namespace}.ServiceBus.Windows.NET/{NotificationHub}/Registrations/?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.
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. |
401 | Errore di autorizzazione. Chiave di accesso non corretta. |
404 | Elemento non trovato. L'hash del canale non esiste. |
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>