Conjuntos de API REST simplificados

  • Artigo

Os conjuntos de API REST simplificados para gerir entidades são os seguintes:

  • GET em qualquer nó de nomenclatura desocupado (por exemplo, /ou /test) é uma operação de deteção e devolve um feed AtomPub que lista subordinados. Só devolverá o "nó imediato". Por exemplo, se tiver filas em A/B/C e efetuar um GET em "/", devolve "/A". Se efetuar um GET em "/A", devolve apenas "/A/B" e assim sucessivamente.

  • "GET" em relação a qualquer nó ocupado (por exemplo, /test1/test2, /test1/exemplo ou /test2) é uma operação get e devolve uma AtomPub entrada com a descrição.

  • "PUT" em qualquer nó desocupado é uma operação de criação. O corpo do pedido é e AtomPub a entrada com a descrição.

  • "ELIMINAR" em qualquer nó ocupado é uma operação de eliminação.

  • "DELETE" em relação a qualquer nó desocupado é ignorado e devolve êxito.

Descrições de Entidades

Uma fila é descrita com um QueueDescription elemento. O esquema de detalhes do elemento pode ser diretamente inferido a partir da classe queueDescription .NET Framework. Por conseguinte, o payload XML para criar ou atualizar uma fila pode assumir o seguinte formulário, pelo que todas as propriedades omitidas assumem os respetivos valores predefinidos:

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

Os tópicos são descritos com <TopicDescription> o elemento . O esquema de detalhes do elemento pode ser diretamente inferido a partir da classe topicDescription .NET Framework.

As subscrições são descritas com o <SubscriptionDescription> elemento . O esquema de detalhes do elemento pode ser diretamente inferido a partir da classe subscriptionDescription .NET Framework.

As subscrições são subordinadas de Tópicos e, por conseguinte, têm de ser criadas na coleção "subscrições" de um tópico existente. Se o caminho da entidade do tópico for https://{serviceNamespace}.servicebus.windows.net/{topic-name}, o caminho correto para criar uma nova subscrição é https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}. Os nomes das subscrições não podem ter vários segmentos.

As regras são descritas com o <RuleDescription> elemento . O esquema de detalhes do elemento pode ser diretamente inferido a partir da classe ruleDescription .NET Framework.

As regras são subordinadas de subscrições de tópicos e, por conseguinte, têm de ser criadas na coleção de "regras" de uma subscrição de tópico existente. Se o caminho da entidade da subscrição do tópico for https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}, o caminho correto para criar uma nova regra é https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}/rules/{rule-name}. Os nomes das subscrições não podem ter vários segmentos.