Compartir a través de

Conjuntos de API REST simplificados

  • Artículo

Los conjuntos de API de REST simplificados para administrar entidades son como se indica a continuación:

  • La operación de detección GET sobre cualquier nodo de nomenclaturas desocupado (por ejemplo, / o /test) devuelve una fuente AtomPub con un listado de los elementos secundarios. Solo devolverá el "nodo más próximo". Por ejemplo, si tiene las colas en A/B/C y realiza una operación GET sobre "/", devuelve "/A". Si realiza una operación GET sobre "/A", solo devuelve "/A/B" y así sucesivamente.

  • Si se realiza "GET" sobre un nodo ocupado (por ejemplo, /test1/test2, /test1/example o /test2), se lleva a cabo una operación Get y se devuelve una entrada AtomPub con la descripción.

  • Si se realiza "PUT" sobre cualquier nodo desocupado, se lleva a cabo una operación de creación. El cuerpo de la solicitud es una entrada AtomPub con la descripción.

  • Si se realiza "DELETE" sobre cualquier nodo ocupado, se lleva a cabo una operación de eliminación.

  • Si se realiza "DELETE" sobre cualquier nodo desocupado, se ignora y se devuelve que la operación se ha realizado correctamente.

Descripciones de entidad

Una cola se describe con un QueueDescription elemento . El esquema detallado del elemento se puede deducir directamente de la clase QueueDescription de .NET Framework. Por lo tanto, la carga XML para crear o actualizar una cola puede tener la siguiente forma, por lo que todas las propiedades omitidas asumen sus valores predeterminados:

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

Los temas se describen con <TopicDescription> el elemento . El esquema detallado del elemento se puede deducir directamente de la clase TopicDescription de .NET Framework.

Las suscripciones se describen con el <SubscriptionDescription> elemento . El esquema detallado del elemento se puede deducir directamente de la clase SubscriptionDescription de .NET Framework.

Las suscripciones son subordinadas de Temas y, por tanto, deben crearse dentro de la colección "subscriptions" de un tema existente. Si la ruta de acceso de entidad del tema es https://{serviceNamespace}.servicebus.windows.net/{topic-name}, la ruta de acceso correcta para crear una nueva suscripción es https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}. Los nombres de suscripción no pueden tener varios segmentos.

Las reglas se describen con el <RuleDescription> elemento . El esquema detallado del elemento se puede deducir directamente de la clase RuleDescription de .NET Framework.

Las reglas son subordinadas de las suscripciones de temas y, por tanto, deben crearse dentro de la colección "rules" de una suscripción de tema existente. Si la ruta de acceso de entidad de la suscripción de tema es https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}, la ruta de acceso correcta para crear una nueva regla es https://{serviceNamespace}.servicebus.windows.net/{topic-name}/subscriptions/{subscription-name}/rules/{rule-name}. Los nombres de suscripción no pueden tener varios segmentos.