Conjuntos simplificados de API REST

Os conjuntos de APIs REST simplificadas para entidades de gerenciamento são os seguintes:

  • GET em qualquer nó de nomenclatura não ocupado (por exemplo, / ou /test) é uma operação de descoberta e retorna um feed AtomPub listando filhos. Retorna somente o "nó imediato". Por exemplo, se você tiver filas em A/B/C e executar GET em “/”, ele retorna “/A”. Se você executar GET em “/A”, ele retorna somente “/A/B” e assim por diante.

  • “GET” com relação a qualquer nó ocupado (por exemplo, /test1/test2, /test1/example ou /test2) é uma operação de obtenção e retorna uma entrada AtomPub com a descrição.

  • “PUT” com relação a qualquer nó não ocupado é uma operação de criação. O corpo da solicitação é uma entrada AtomPub com a descrição.

  • “DELETE” com relação a qualquer nó ocupado é uma operação de exclusão.

  • “DELETE” com relação a qualquer nó não ocupado é ignorado e retorna sucesso.

Descrições de entidade

Uma fila é descrita com um QueueDescription elemento . O esquema de detalhes para o elemento pode ser inferido diretamente da classe .NET Framework QueueDescription. O conteúdo XML para criar ou atualizar uma fila, portanto, pode assumir o seguinte formulário, pelo qual todas as propriedades omitidas pressupõem seus valores padrão:

<?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 inferido diretamente da classe TopicDescription .NET Framework.

As assinaturas são descritas com o <SubscriptionDescription> elemento . O esquema de detalhes para o elemento pode ser inferido diretamente da classe subscriptionDescription .NET Framework.

As assinaturas são subordinadas de Tópicos e, portanto, devem ser criadas na coleção "assinaturas" 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 assinatura será https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}. Os nomes de assinatura não podem ter vários segmentos.

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

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