Uppräkning

Artikel
08/05/2023

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.

Dela via