Get Relays
Wichtig
Diese API ist veraltet und seit dem 11.1.2021 eingestellt und sollte nicht mehr verwendet werden.
Dieser Vorgang listet die öffentlich verfügbaren Relayendpunkte in einem Dienstnamespace auf.
Anforderung
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| GET |
https://management.core.windows.net/{subscription ID}/services/ServiceBus/ Namespaces/{Namespace}/Relays/$skip={skip}&$top={top} wobei {skip} die Anzahl der zu überspringenden Einträge und {top} die Anzahl der abzurufenden Einträge ist. |
HTTP/1.1 |
Anforderungsheader
In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.
| Anforderungsheader | BESCHREIBUNG |
|---|---|
| Namespace | Verwaltungsendpunkt-URL |
| x-ms-version | 2012-03-01 |
Beachten Sie, dass die Anforderung außerdem ein Clientzertifikat erfordert. Dieses Zertifikat muss mit dem Zertifikat übereinstimmen, das Sie für dieses bestimmte Abonnement hochgeladen haben.
Anforderungstext
Keine.
Antwort
Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.
Antwortcodes
| Code | BESCHREIBUNG |
|---|---|
| 200 | Richtlinien für Relayendpunkte wurden erfolgreich abgerufen. |
| 401 | Autorisierungsfehler Wird zurückgegeben, wenn der Benutzer keine Anmeldeinformationen zum Abrufen von Relayendpunkten für Namespaces hat. Die Ursache kann ein angehaltenes Abonnement sein. |
| 404 | Die Entität ist unter diesem Namespace nicht vorhanden. |
| 500 | Interner bzw. Ausnahmefehler. |
Informationen zu status Codes finden Sie unter Status- und Fehlercodes.
Antwortheader
Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.
| Antwortheader | BESCHREIBUNG |
|---|---|
| Content-Type | application/xml;type=collection;charset=utf-8 |
Antworttext
Die API gibt ein XML AtomPub-Dokument zurück, das jede Relayendpunktrichtlinie mit den folgenden Elementen darstellt:
| Eigenschaftenname | type | BESCHREIBUNG |
|---|---|---|
| Name | String | Endpunktname |
| Listenertyp | String | Gruppe von Listenerntyp. Gültige Werte: -Unicast -Multicast – DirectConnection – HybridConnection - RelayedConnection – RelayedHttp |
| NumberOfListeners | Integer | Anzahl der aktuell aktiven Listener |