Condividi tramite

Set di API REST semplificati

  • Articolo

I set di API REST semplificate per la gestione delle entità sono i seguenti:

  • GET su un nodo di denominazione non occupato (ad esempio / o /test) è un'operazione di individuazione e restituisce un feed AtomPub che elenca elementi figlio. Restituirà solo il "nodo immediato". Se ad esempio sono presenti code in A/B/C e si esegue GET su "/", verrà restituito "/A". Se si esegue GET su "/A", verrà restituito solo "/A/B" e così via.

  • "GET" su un nodo occupato (ad esempio /test1/test2, /test1/esempio o /test2) è un'operazione di recupero e restituisce una voce AtomPub con la descrizione.

  • "PUT" su un nodo non occupato è un'operazione di creazione. Il corpo della richiesta è una voce AtomPub con la descrizione.

  • "DELETE" su un nodo occupato è un'operazione di eliminazione.

  • "DELETE" su un nodo non occupato è un'operazione che viene ignorata e restituisce un risultato positivo.

Descrizioni delle entità

Una coda viene descritta con un QueueDescription elemento . Lo schema di dettaglio per l'elemento può essere dedotto direttamente dalla classe QueueDescription .NET Framework. Il payload XML per la creazione o l'aggiornamento di una coda può pertanto assumere il formato seguente, in cui tutte le proprietà omesse presuppongono i valori predefiniti:

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

Gli argomenti vengono descritti con <TopicDescription> l'elemento . Lo schema di dettaglio per l'elemento può essere dedotto direttamente dalla classe TopicDescription .NET Framework.

Le sottoscrizioni vengono descritte con l'elemento <SubscriptionDescription> . Lo schema di dettaglio per l'elemento può essere dedotto direttamente dalla classe SubscriptionDescription .NET Framework.

Le sottoscrizioni sono subordinate a Topics e devono quindi essere create all'interno della raccolta "sottoscrizioni" di un argomento esistente. Se il percorso dell'entità dell'argomento è https://{serviceNamespace}.servicebus.windows.net/{topic-name}, il percorso corretto per la creazione di una nuova sottoscrizione è https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}. I nomi delle sottoscrizioni non possono avere più segmenti.

Le regole vengono descritte con l'elemento <RuleDescription> . Lo schema di dettaglio per l'elemento può essere dedotto direttamente dalla classe RuleDescription .NET Framework.

Le regole sono subordinate alle sottoscrizioni di argomenti e pertanto devono essere create all'interno della raccolta "regole" di una sottoscrizione di argomento esistente. Se il percorso dell'entità della sottoscrizione dell'argomento è https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}, il percorso corretto per la creazione di una nuova regola è https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}/rules/{rule-name}. I nomi delle sottoscrizioni non possono avere più segmenti.