简化的 REST API 集

用于管理实体的简化 REST API 集如下：

• 对任何未占用的命名节点（例如 / 或 /test）执行 GET 是一个发现操作，将返回列出子项的 AtomPub 源。 它仅返回“即时节点”。 例如，如果队列位于 A/B/C，此时若对“/”执行 GET，则将返回“/A”。 如果对“/A”执行 GET，则将只返回“/A/B”，依此类推。

• 对任何已占用的节点（例如 /test1/test2、/test1/example 或 /test2）执行“GET”是一个 get 操作，将返回 AtomPub 条目以及相关描述。

• 对任何未占用的节点执行“PUT”是一个 create 操作。 请求正文是 AtomPub 条目以及相关描述。

• 对任何已占用的节点执行“DELETE”是一个 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 类直接推断元素的详细信息架构。

订阅是 Topics 的从属，因此必须在现有主题的“订阅”集合中创建。 如果主题的实体路径为 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}。 订阅名称不能有多个段。