Get Relays
Important
Cette API est obsolète et mise hors service à compter du 1/11/2021 et ne doit plus être utilisée.
Cette opération énumère les points de terminaison de relais disponibles publiquement dans un espace de noms de service.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| GET |
https://management.core.windows.net/{subscription ID}/services/ServiceBus/ Namespaces/{Namespace}/Relays/$skip={skip}&$top={top} où {skip} est le nombre d’entrées à ignorer, et {top} est le nombre d’entrées à récupérer. |
HTTP/1.1 |
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 |
|---|---|
| Espace de noms | URL du point de terminaison de gestion |
| x-ms-version | 2012-03-01 |
Notez que la demande nécessite également un certificat client. Ce certificat doit correspondre à celui que vous avez téléchargé pour cet abonnement.
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 | Stratégies de points de terminaison de relais récupérées avec succès. |
| 401 | Échec de l'autorisation. Retourné lorsque l’utilisateur ne dispose pas d’informations d’identification pour récupérer les stratégies de points de terminaison de relais des espaces de noms. Ceci peut être du à la suspension d'un abonnement. |
| 404 | L'entité n'existe pas sous cet espace de noms. |
| 500 | Exception interne/non prise en charge. |
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 également 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 |
|---|---|
| Content-Type | application/xml;type=collection;charset=utf-8 |
Corps de la réponse
L’API retourne un document Xml AtomPub qui représente chaque stratégie de point de terminaison de relais, avec les éléments suivants :
| Nom de la propriété | Type | Description |
|---|---|---|
| Nom | String | Nom du point de terminaison |
| Type d’écouteur | String | Type de groupe d’écouteurs. Valeurs valides : -Unicast -Multidiffusion - DirectConnection - HybridConnection - RelayedConnection - RelayedHttp |
| NumberOfListeners | Integer | Nombre d’écouteurs actifs actuels |