Enumerazione

L'operazione Discovery consente di spostarsi all'interno di spazi dei nomi gerarchici, mentre Enumeration consente di elencare tutte le entità di un determinato tipo in una visualizzazione semplice. L'enumerazione viene eseguita sulla raccolta di risorse riservate speciale ($Resources) che risiede nella radice dello spazio dei nomi del servizio. Per le funzionalità, l'enumerazione viene eseguita rispetto all'indirizzo della raccolta, ad esempio "/subscriptions" o "/rules" per le sottoscrizioni e le regole di un argomento.

Richiesta

La richiesta per l'enumerazione può essere costruita come segue.

Metodo	URI richiesta	Versione HTTP
GET	https://{serviceNamespace}.servicebus.windows.net/$Resources/{resourceCollection} oppure https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions oppure https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions/{subscription-name}/rules	HTTP/1.1

Parametri di query $skip e $top

L'enumerazione supporta il paging. È possibile recuperare un intervallo di entità nello spazio dei nomi del servizio. Il parametro di query $skip indica il numero di voci che la richiesta deve ignorare quando restituisce un'enumerazione e $top quante voci devono essere restituite.

Intestazioni richiesta

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

Intestazione della richiesta	Descrizione
Autorizzazione	Specifica un token di firma di accesso condiviso con diritti "Gestisci". Per informazioni dettagliate, vedere Autenticazione del bus di servizio con firme di accesso condiviso .

Corpo della richiesta

Nessuno.

Risposta

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

Codici di risposta

Codice	Descrizione
200	OK.
401	Non autorizzato. La richiesta non è autorizzata.

Nota

Se non esistono entità, viene restituito un feed vuoto.

Per informazioni sui codici di stato, vedere Codici di stato e di errore.

Intestazioni della risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

Intestazione di risposta	Descrizione
Tipo di contenuto	Content-Type: application/atom+xml; type=entry

Corpo della risposta

Al completamento dell'operazione, viene restituito un feed Atom contenente più voci Atom che elencano tutte le risorse disponibili di un determinato tipo nello spazio dei nomi in questione. Ad esempio:

<?xml version="1.0" encoding="utf-8" ?>  
<feed xmlns='http://www.w3.org/2005/Atom'>  
  <entry>  
    <id>https://{serviceNamespace}.Windows.net/{path}</id>  
    <published>{createdTime}</published>  
    <updated>{lastUpdatedTime}</updated>  
    <link rel='self'>https://{serviceNamespace}.servicebus.Windows.net/{path}</link>  
    <content type='application/xml'>  
      {description}
    </content>  
  </entry>  
</feed>  

Per il contenuto possibile dell'elemento {description}, vedere Panoramica.