Énumération

Article
08/05/2023

L'opération Discovery accède aux espaces de noms hiérarchiques, tandis que l'opération Enumeration vous permet de répertorier toutes les entités d'un certain type dans un affichage en 2D. L’énumération est effectuée sur la collection de ressources réservées spéciale ($Resources) qui réside à la racine de l’espace de noms de service. Pour les fonctionnalités, l'énumération se produit en fonction de l'adresse de la collection, par exemple, « /abonnements » ou « /règles » pour les abonnements et règles sur une rubrique.

Requête

Vous pouvez construire la demande Enumeration comme suit.

Méthode	URI de demande	Version HTTP
GET	https://{serviceNamespace}.servicebus.windows.net/$Resources/{resourceCollection} or https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions or https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions/{subscription-name}/rules	HTTP/1.1

Paramètres de requête $skip et $top

L’énumération prend en charge la pagination. Vous pouvez récupérer une plage d’entités sous votre espace de noms de service. Le paramètre de requête $skip indique le nombre d’entrées que la demande doit ignorer lors du renvoi d’une énumération et $top combien d’entrées doivent être retournées.

En-têtes de requête

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.

En-tête de requête	Description
Autorisation	Spécifie un jeton de signature d’accès partagé (SAP) avec des droits « Gérer ». Pour plus d’informations, consultez Authentification Service Bus avec signatures d’accès partagé .

Corps de la requête

Aucun.

response

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.

Codes de réponse

Code	Description
200	OK.
401	Non autorisé. La demande n’est pas autorisée.

Remarque

Un flux vide est renvoyé si aucune entité n'existe.

Pour plus d’informations sur les codes status, consultez Codes d’état et d’erreur.

En-têtes de réponse

La réponse de l'opération inclut les en-têtes suivants. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.

En-tête de réponse	Description
Type de contenu	Content-Type : application/atom+xml; type=entry

Corps de la réponse

En cas de succès, un flux Atom contenant plusieurs entrées Atom répertoriant toutes les ressources disponibles d'un type donné dans l'espace de noms spécifié est renvoyé. Par exemple :

<?xml version="1.0" encoding="utf-8" ?>  
<feed xmlns='http://www.w3.org/2005/Atom'>  
  <entry>  
    <id>https://{serviceNamespace}.Windows.net/{path}</id>  
    <published>{createdTime}</published>  
    <updated>{lastUpdatedTime}</updated>  
    <link rel='self'>https://{serviceNamespace}.servicebus.Windows.net/{path}</link>  
    <content type='application/xml'>  
      {description}
    </content>  
  </entry>  
</feed>

Pour connaître le contenu possible de l’élément {description}, consultez Vue d’ensemble.

Partager via