Lettura su tutte le registrazioni con un tag

  • Articolo

 

Recupera tutte le registrazioni con un tag specifico.

Richiesta

Metodo URI della richiesta Versione HTTP
GET https://{Namespace}.ServiceBus.Windows.NET/{NotificationHub}/Tags/{tag}/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

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>