Delen via

Vereenvoudigde REST API-sets

  • Artikel

De vereenvoudigde REST API-sets voor het beheren van entiteiten zijn als volgt:

  • GET op een niet-bezet naamgevingsknooppunt (bijvoorbeeld / of /test) is een detectiebewerking en retourneert een AtomPub-feed met onderliggende items. Er wordt alleen het 'directe knooppunt' geretourneerd. Als u bijvoorbeeld wachtrijen op A/B/C hebt en een GET uitvoert op '/', wordt /A geretourneerd. Als u een GET uitvoert op '/A', retourneert deze alleen '/A/B', enzovoort.

  • 'GET' voor een bezet knooppunt (bijvoorbeeld /test1/test2, /test1/example of /test2) is een get-bewerking en retourneert een AtomPub vermelding met de beschrijving.

  • 'PUT' tegen een leeg knooppunt is een maakbewerking. De aanvraagbody is en AtomPub vermelding met de beschrijving.

  • 'DELETE' voor een bezet knooppunt is een verwijderbewerking.

  • 'DELETE' tegen een niet-bezet knooppunt wordt genegeerd en retourneert een geslaagde bewerking.

Entiteitsbeschrijvingen

Een wachtrij wordt beschreven met een QueueDescription -element. Het detailschema voor het -element kan rechtstreeks worden afgeleid uit de .NET Framework-klasse QueueDescription. De XML-nettolading voor het maken of bijwerken van een wachtrij kan daarom de volgende vorm hebben, waarbij voor alle weggelaten eigenschappen worden uitgegaan van de standaardwaarden:

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

Onderwerpen worden beschreven met <TopicDescription> element. Het detailschema voor het -element kan rechtstreeks worden afgeleid uit de klasse TopicDescription .NET Framework.

Abonnementen worden beschreven met het <SubscriptionDescription> -element. Het detailschema voor het element kan rechtstreeks worden afgeleid uit de .NET Framework-klasse SubscriptionDescription.

Abonnementen zijn ondergeschikten van Onderwerpen en moeten daarom worden gemaakt binnen de verzameling 'abonnementen' van een bestaand onderwerp. Als het entiteitspad van het onderwerp is, is https://{serviceNamespace}.servicebus.windows.net/{topic-name}https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}het juiste pad voor het maken van een nieuw abonnement . Abonnementsnamen mogen niet meerdere segmenten hebben.

Regels worden beschreven met het <RuleDescription> -element. Het detailschema voor het element kan rechtstreeks worden afgeleid uit de RuleDescription .NET Framework klasse.

Regels zijn ondergeschikten van onderwerpabonnementen en moeten daarom worden gemaakt binnen de verzameling 'regels' van een bestaand onderwerpabonnement. Als het entiteitspad van het onderwerpabonnement is, is https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}/rules/{rule-name}het juiste pad voor het maken van een nieuwe regel . Abonnementsnamen mogen niet meerdere segmenten hebben.