Wyliczenie

Operacja odnajdywania przechodzi w hierarchicznych przestrzeniach nazw, a wyliczenie umożliwia wyświetlanie listy wszystkich jednostek określonego rodzaju w widoku płaskim. Wyliczenie jest wykonywane względem specjalnej kolekcji zasobów zarezerwowanych ($Resources), która znajduje się w katalogu głównym przestrzeni nazw usługi. W przypadku funkcji wyliczenie odbywa się w odniesieniu do adresu kolekcji; na przykład "/subscriptions" lub "/rules" dla subskrypcji i reguł w temacie.

Żądanie

Możesz skonstruować żądanie wyliczenia w następujący sposób.

Metoda	Identyfikator URI żądania	Wersja protokołu HTTP
GET	https://{serviceNamespace}.servicebus.windows.net/$Resources/{resourceCollection} lub https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions lub https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions/{subscription-name}/rules	HTTP/1.1

Parametry zapytania $skip i $top

Wyliczenie obsługuje stronicowanie. Zakres jednostek można pobrać w przestrzeni nazw usługi. Parametr zapytania $skip wskazuje, ile wpisów żądanie należy pominąć podczas zwracania wyliczenia i $top ile wpisów zostanie zwróconych.

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania	Opis
Autoryzacja	Określa token sygnatury dostępu współdzielonego (SAS) z prawami "Zarządzaj". Aby uzyskać szczegółowe informacje , zobacz Uwierzytelnianie usługi Service Bus z sygnaturami dostępu współdzielonego .

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kody odpowiedzi

Kod	Opis
200	OK.
401	Brak autoryzacji. Żądanie nie jest autoryzowane.

Uwaga

Puste źródło danych jest zwracane, jeśli nie istnieją żadne jednostki.

Aby uzyskać informacje o kodach stanu, zobacz Kody stanu i błędów.

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi	Opis
Typ zawartości	Typ zawartości: application/atom+xml; type=entry

Treść odpowiedzi

Po pomyślnym zakończeniu zwracany jest kanał informacyjny Atom zawierający wiele wpisów Atom zawierający wszystkie dostępne zasoby danego typu w danej przestrzeni nazw. Przykład:

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

Aby uzyskać możliwą zawartość elementu {description}, zobacz Omówienie.