Énumération
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.