簡化的 REST API 集合

發行項
07/19/2023

用以管理實體的簡化 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 類別直接推斷專案的詳細架構。

規則是主題訂閱的次級，因此必須在現有主題訂閱的「規則」集合內建立。如果主題訂閱的實體路徑是 https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name} ，則建立新規則的正確路徑為 https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}/rules/{rule-name} 。訂用帳戶名稱不能有多個區段。

簡化的 REST API 集合

實體描述

其他資源