Enumeration

Artikel
08/05/2023

Der Ermittlungsvorgang navigiert in hierarchischen Namespaces, während die Enumeration das Auflisten aller Entitiäten eines bestimmten Typs in einer flachen Ansicht ermöglicht. Die Enumeration wird für die spezielle reservierte Ressourcensammlung ($Resources) ausgeführt, die sich im Stammverzeichnis des Dienstnamespace befindet. Für Funktionen findet die Enumeration unter Berücksichtigung der Auflistungsadresse statt. Beispiel: /subscriptions oder /rules für Abonnements und Regeln für ein Thema.

Anforderung

Die Anforderung Enumeration kann wie folgt generiert werden.

Methode	Anforderungs-URI	HTTP-Version
GET	https://{serviceNamespace}.servicebus.windows.net/$Resources/{resourceCollection} oder https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions oder https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions/{subscription-name}/rules	HTTP/1.1

Abfrageparameter $skip und $top

Die Enumeration unterstützt paging. Sie können einen Bereich von Entitäten unter Ihrem Dienstnamespace abrufen. Der Abfrageparameter $skip gibt an, wie viele Einträge die Anforderung überspringen soll, wenn eine Enumeration zurückgegeben wird, und $top, wie viele Einträge zurückgegeben werden sollen.

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader	BESCHREIBUNG
Authorization	Gibt ein SAS-Token (Shared Access Signature) mit Den Berechtigungen "Verwalten" an. Weitere Informationen finden Sie unter Service Bus-Authentifizierung mit Shared Access Signatures .

Anforderungstext

Keine.

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Antwortcodes

Code	BESCHREIBUNG
200	OK.
401	Nicht autorisiert. Die Anforderung ist nicht autorisiert.

Hinweis

Ein leerer Feed wird zurückgegeben, wenn keine Entitäten vorhanden sind.

Informationen zu status Codes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antwortheader	BESCHREIBUNG
Inhaltstyp	Content-Type: application/atom+xml; type=entry

Antworttext

Bei Erfolg wird ein Atom-Feed zurückgegeben, der mehrere Atom-Einträge enthält, die alle verfügbaren Ressourcen des angegebenen Typs im angegebenen Namespace auflisten. Beispiel:

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

Den möglichen Inhalt des {description}-Elements finden Sie unter Übersicht.

Freigeben über