Zjednodušené sady rozhraní REST API

Zjednodušené sady rozhraní REST API pro správu entit jsou následující:

  • GET na jakémkoli neobsazených názvových uzlech (například / nebo /test) je operace zjišťování a vrací informační kanál AtomPub se seznamem podřízených položek. Vrátí pouze "okamžitý uzel". Pokud máte například fronty v A/B/C a provedete get na "/", vrátí se "/A". Pokud provedete operaci GET pro /A, vrátí pouze /A/B atd.

  • Get pro libovolný obsazený uzel (například /test1/test2, /test1/example nebo /test2) je operace get a vrátí položku s popisem AtomPub .

  • "PUT" u jakéhokoli neobsazeného uzlu je operace vytvoření. Text požadavku je a AtomPub položka s popisem.

  • "DELETE" u libovolného obsazeného uzlu je operace odstranění.

  • Příkaz DELETE u jakéhokoli neobsazeného uzlu se ignoruje a vrátí úspěch.

Popisy entit

Fronta je popsána pomocí elementu QueueDescription . Podrobné schéma pro element lze přímo odvodit z třídy .NET Framework QueueDescription . Datová část XML pro vytvoření nebo aktualizaci fronty proto může mít následující podobu, přičemž všechny vynechané vlastnosti přebírají výchozí hodnoty:

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

Témata jsou popsána pomocí <TopicDescription> elementu . Podrobné schéma pro element lze přímo odvodit z Třídy Rozhraní .NET Framework TopicDescription .

Předplatná jsou popsána pomocí elementu <SubscriptionDescription> . Podrobné schéma pro element lze přímo odvodit z Třídy Rozhraní .NET Framework SubscriptionDescription .

Odběry jsou podřízené tématům, a proto musí být vytvořeny v kolekci "odběrů" existujícího tématu. Pokud je https://{serviceNamespace}.servicebus.windows.net/{topic-name}cesta k entitě tématu , správná cesta pro vytvoření nového předplatného je https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}. Názvy předplatného nemůžou mít více segmentů.

Pravidla jsou popsána pomocí elementu <RuleDescription> . Podrobné schéma pro element lze přímo odvodit z třídy Rozhraní .NET Framework RuleDescription .

Pravidla jsou podřízená odběrům témat, a proto musí být vytvořena v kolekci "pravidel" existujícího odběru témat. Pokud je https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}cesta k entitě odběru tématu , správná cesta pro vytvoření nového pravidla je https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}/rules/{rule-name}. Názvy předplatného nemůžou mít více segmentů.