Dela via


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.