簡略化された REST API セット

  • [アーティクル]

エンティティ管理のための簡略化された REST API セットは次のようになります。

  • 使用されていないネーミング ノード (たとえば、/ や /test など) に対する GET は検出操作であり、子をリストした AtomPub フィードを返します。 返されるのは "即時ノード" のみです。 たとえば、A/B/C にキューがある場合、"/" に対して GET を実行すると、"/A" が返されます。 "/A" に対して GET を実行すると、"/A/B" のみが返されます (以降同様)。

  • 使用されているノード (たとえば、/test1/test2、/test1/example、/test2 など) に対する “GET” は取得操作であり、AtomPub エントリと説明が返されます。

  • 使用されていないノードに対する "PUT" は、作成操作です。 要求の本文は AtomPub エントリと説明です。

  • 使用されているノードに対する "DELETE" は、削除操作です。

  • 使用されていないノードに対する "DELETE" は無視され、成功を返します。

エンティティの説明

キューは 要素と共に QueueDescription 記述されます。 要素の詳細スキーマは、QueueDescription .NET Framework クラスから直接推論できます。 したがって、キューを作成または更新するための XML ペイロードは次の形式になる場合があります。したがって、省略されたすべてのプロパティは既定値と見なされます。

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

トピックについては、 要素を使用して <TopicDescription> 説明します。 要素の詳細スキーマは、TopicDescription .NET Framework クラスから直接推論できます。

サブスクリプションについては、 要素を使用して <SubscriptionDescription> 説明します。 要素の詳細スキーマは、SubscriptionDescription .NET Framework クラスから直接推論できます。

サブスクリプションはトピックの下位であるため、既存のトピックの "サブスクリプション" コレクション内に作成する必要があります。 トピックのエンティティ パスが の場合、 https://{serviceNamespace}.servicebus.windows.net/{topic-name}新しいサブスクリプションを作成するための正しいパスは です https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}。 サブスクリプション名に複数のセグメントを含めることはできません。

ルールは、 要素と共に <RuleDescription> 記述されます。 要素の詳細スキーマは、RuleDescription .NET Framework クラスから直接推論できます。

ルールはトピック サブスクリプションの下位であるため、既存のトピック サブスクリプションの "rules" コレクション内に作成する必要があります。 トピック サブスクリプションのエンティティ パスが の場合、 https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}新しいルールを作成するための正しいパスは です https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}/rules/{rule-name}。 サブスクリプション名に複数のセグメントを含めることはできません。