Dela via

Förenklade REST API-uppsättningar

  • Artikel

De förenklade REST API-uppsättningarna för att hantera entiteter är följande:

  • GET på valfri obebodd namngivningsnod (till exempel / eller /test) är en identifieringsåtgärd och returnerar en AtomPub-feed som visar underordnade. Den returnerar bara den "omedelbara noden". Om du till exempel har köer på A/B/C och utför en GET på "/" returneras "/A". Om du utför en GET på "/A" returneras endast "/A/B" och så vidare.

  • "GET" mot alla upptagna noder (till exempel /test1/test2, /test1/example eller /test2) är en get-åtgärd och returnerar en AtomPub post med beskrivningen.

  • "PUT" mot alla obebodda noder är en skapandeåtgärd. Begärandetexten är och AtomPub posten med beskrivningen.

  • "DELETE" mot alla upptagna noder är en borttagningsåtgärd.

  • "DELETE" mot alla obebodda noder ignoreras och returnerar framgång.

Entitetsbeskrivningar

En kö beskrivs med ett QueueDescription element. Detaljschemat för elementet kan härledas direkt från klassen QueueDescription .NET Framework. XML-nyttolasten för att skapa eller uppdatera en kö kan därför ha följande formulär, där alla utelämnade egenskaper förutsätter sina standardvärden:

<?xml version="1.0" encoding="utf-8" ?>  
<entry xmlns="http://www.w3.org/2005/Atom">  
  <content type="application/xml">  
    <QueueDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
       <LockDuration>T1M</LockDuration>
    </QueueDescription>
  </content>  
</entry>

Ämnen beskrivs med <TopicDescription> element. Detaljschemat för elementet kan härledas direkt från klassen TopicDescription .NET Framework.

Prenumerationer beskrivs med -elementet <SubscriptionDescription> . Informationsschemat för elementet kan härledas direkt från klassen SubscriptionDescription .NET Framework.

Prenumerationer är underordnade ämnen och måste därför skapas i samlingen "prenumerationer" för ett befintligt ämne. Om entitetssökvägen för ämnet är https://{serviceNamespace}.servicebus.windows.net/{topic-name}är https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}rätt sökväg för att skapa en ny prenumeration . Prenumerationsnamn får inte ha flera segment.

Regler beskrivs med -elementet <RuleDescription> . Informationsschemat för elementet kan härledas direkt från klassen RuleDescription .NET Framework.

Regler är underordnade ämnesprenumerationer och måste därför skapas i samlingen "regler" för en befintlig ämnesprenumeration. Om entitetssökvägen för ämnesprenumerationen är https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}är https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}/rules/{rule-name}rätt sökväg för att skapa en ny regel . Prenumerationsnamn får inte ha flera segment.