Uppräkning
Identifieringsåtgärden navigerar i hierarkiska namnrymder, medan Uppräkning gör att du kan visa en lista över alla entiteter av en viss typ i en platt vy. Uppräkning utförs mot den särskilda reserverade resurssamlingen ($Resources) som finns i roten för tjänstnamnområdet. För funktioner sker uppräkning med avseende på insamlingsadressen. till exempel "/subscriptions" eller "/rules" för prenumerationer och regler för ett ämne.
Förfrågan
Du kan skapa uppräkningsbegäran på följande sätt.
Metod | URI för förfrågan | HTTP-version |
---|---|---|
GET | https://{serviceNamespace}.servicebus.windows.net/$Resources/{resourceCollection} eller https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions eller https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions/{subscription-name}/rules |
HTTP/1.1 |
Frågeparametrar $skip och $top
Uppräkning stöder sidindelning. Du kan hämta ett intervall med entiteter under tjänstnamnområdet. Frågeparametern $skip anger hur många poster som begäran ska hoppa över när en uppräkning returneras och $top hur många poster som ska returneras.
Rubriker för begäran
I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.
Begärandehuvud | Description |
---|---|
Auktorisering | Anger en SAS-token (signatur för delad åtkomst) med behörigheten "Hantera". Mer information finns i Service Bus-autentisering med signaturer för delad åtkomst . |
Begärandetext
Inga.
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Svarskoder
Kod | Description |
---|---|
200 | OK. |
401 | Behörighet saknas. Begäran har inte behörighet. |
Anteckning
En tom feed returneras om det inte finns några entiteter.
Information om statuskoder finns i Status och Felkoder.
Svarsrubriker
Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.
Svarshuvud | Description |
---|---|
Innehållstyp | Innehållstyp: application/atom+xml; type=entry |
Svarstext
När det lyckas returneras ett Atom-flöde som innehåller flera Atom-poster som visar alla tillgängliga resurser av den angivna typen i det angivna namnområdet. Exempel:
<?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>
Det möjliga innehållet i elementet {description} finns i Översikt.