Egyszerűsített REST API-készletek

  • Cikk

Az entitások kezelésére szolgáló egyszerűsített REST API-készletek a következők:

  • A GET bármely nem elfoglalt elnevezési csomóponton (például / vagy /test) egy felderítési művelet, és egy AtomPub-hírcsatornát ad vissza, amely a gyermekeket sorolja fel. Csak az "azonnali csomópontot" adja vissza. Ha például várólisták vannak az A/B/C-ben, és a GET értéket a következőn hajtja végre: "/", az "/A" értéket adja vissza. Ha a GET értéket a "/A" értéken hajtja végre, az csak a "/A/B" értéket adja vissza, és így tovább.

  • A "GET" bármely elfoglalt csomóponton (például /test1/test2, /test1/example vagy /test2) egy lekérési művelet, és egy leírást tartalmazó bejegyzést AtomPub ad vissza.

  • A "PUT" bármilyen nem feltöltött csomóponton létrehozási művelet. A kérelem törzse és AtomPub a leírást tartalmazó bejegyzés.

  • A "DELETE" bármely elfoglalt csomóponton törlési művelet.

  • A rendszer figyelmen kívül hagyja a "DELETE" értéket a nem megnyitott csomópontok között, és sikeres lesz.

Entitás leírása

Az üzenetsorokat egy QueueDescription elem ismerteti. Az elem részletes sémája közvetlenül a QueueDescription .NET-keretrendszer osztályból következtethető ki. Az üzenetsor létrehozásához vagy frissítéséhez szükséges XML-hasznos adat ezért a következő űrlapot öltheti, amelyben az összes kihagyott tulajdonság feltételezi az alapértelmezett értékeket:

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

A témaköröket elemekkel <TopicDescription> írják le. Az elem részletes sémája közvetlenül a TopicDescription .NET-keretrendszer osztályból következtethető ki.

Az előfizetéseket az <SubscriptionDescription> elem ismerteti. Az elem részletes sémája közvetlenül a SubscriptionDescription .NET-keretrendszer osztályból következtethető ki.

Az előfizetések a témakörök alárendeltjei, ezért egy meglévő témakör "előfizetések" gyűjteményében kell létrehozni. Ha a témakör entitásútvonala , https://{serviceNamespace}.servicebus.windows.net/{topic-name}az új előfizetés létrehozásához a megfelelő elérési út a következő https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}: . Az előfizetések nevei nem tartalmazhatnak több szegmenst.

A szabályokat az <RuleDescription> elem ismerteti. Az elem részletes sémája közvetlenül a RuleDescription .NET-keretrendszer osztályból következtethető ki.

A szabályok a témakör-előfizetések alárendeltjei, ezért egy meglévő témakör-előfizetés "szabályok" gyűjteményében kell létrehozni. Ha a témakör-előfizetés entitáselérési útja , https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}az új szabály létrehozásához a megfelelő elérési út a következő https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}/rules/{rule-name}: . Az előfizetések nevei nem tartalmazhatnak több szegmenst.