간소화된 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"는 무시되며 success를 반환합니다.

엔터티 설명

큐는 요소로 설명됩니다 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}. 구독 이름에는 여러 세그먼트가 있을 수 없습니다.