Упрощенные наборы REST API

  • Статья

Используются следующие упрощенные наборы API REST для управления сущностями:

  • GET на любом незанятом узле именования (например, / или /test) — это операция обнаружения, которая возвращает канал AtomPub, перечисляющий дочерние узлы. Возвращает только "ближайший узел". Например, если имеются очереди на A/B/C и выполняется GET на "/", то возвращается "/A". Если выполняется GET на "/A", возвращается только "/A/B" и т. д.

  • “GET” на любом занятом узле (например, /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}. Имена подписок не могут содержать несколько сегментов.