Inventarisatie

Artikel
08/05/2023

Met de detectiebewerking navigeert u door hiërarchische naamruimten, terwijl u met Opsomming alle entiteiten van een bepaald type kunt weergeven in een platte weergave. Opsomming wordt uitgevoerd op basis van de speciale gereserveerde resourceverzameling ($Resources) die zich in de hoofdmap van de servicenaamruimte bevindt. Voor functies vindt inventarisatie plaats met betrekking tot het verzamelingsadres; bijvoorbeeld '/subscriptions' of '/rules' voor abonnementen en regels voor een onderwerp.

Aanvraag

U kunt de opsommingsaanvraag als volgt samenstellen.

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

Queryparameters $skip en $top

Opsomming ondersteunt paginering. U kunt een reeks entiteiten ophalen onder uw servicenaamruimte. De queryparameter $skip geeft aan hoeveel vermeldingen de aanvraag moet overslaan bij het retourneren van een opsomming en $top hoeveel vermeldingen moeten worden geretourneerd.

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.

Aanvraagkoptekst	Description
Autorisatie	Hiermee geeft u een SAS-token (Shared Access Signature) met 'Beheren'-rechten. Zie Service Bus-verificatie met Shared Access Signatures voor meer informatie.

Aanvraagbody

Geen.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Antwoordcodes

Code	Description
200	OK.
401	Onbevoegd. De aanvraag is niet geautoriseerd.

Notitie

Er wordt een lege feed geretourneerd als er geen entiteiten bestaan.

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Reactieheader	Beschrijving
Inhoudstype	Content-Type: application/atom+xml; type=vermelding

Hoofdtekst van antwoord

Als dit lukt, wordt een Atom-feed met meerdere Atom-vermeldingen met alle beschikbare resources van het opgegeven type in de opgegeven naamruimte geretourneerd. Bijvoorbeeld:

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

Zie Overzicht voor de mogelijke inhoud van het element {description }.

Delen via