Relays ophalen

Belangrijk

Deze API is verouderd en buiten gebruik gesteld vanaf 1-11-2021 en mag niet meer worden gebruikt.

Met deze bewerking worden de openbaar beschikbare relay-eindpunten in een servicenaamruimte opgesomd.

Aanvraag

Methode	Aanvraag-URI	HTTP-versie
GET	https://management.core.windows.net/{subscription ID}/services/ServiceBus/ Naamruimten/{Naamruimte}/Relays/$skip={skip}&$top={top} waarbij {skip} het aantal vermeldingen is dat moet worden overgeslagen en {top} het aantal items dat moet worden opgehaald.	HTTP/1.1

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.

Aanvraagkoptekst	Beschrijving
Naamruimte	URL van beheereindpunt
x-ms-version	2012-03-01

Voor de aanvraag is ook een clientcertificaat vereist. Dit certificaat moet overeenkomen met het certificaat dat u hebt geüpload voor dat specifieke abonnement.

Aanvraagbody

Geen.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Antwoordcodes

Code	Description
200	Het beleid voor relay-eindpunten is opgehaald.
401	Autorisatiefout. Wordt geretourneerd wanneer de gebruiker geen referenties heeft om beleidsregels voor relay-eindpunten voor naamruimten op te halen. Dit kan worden veroorzaakt door een onderbroken abonnement.
404	De entiteit bestaat niet onder deze naamruimte.
500	Interne/onverwerkte uitzondering.

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Reactieheader	Beschrijving
Content-Type	application/xml;type=collection;charset=utf-8

Hoofdtekst van antwoord

De API retourneert een XML AtomPub-document dat elk relay-eindpuntbeleid vertegenwoordigt, met de volgende elementen:

Eigenschapsnaam	Type	Beschrijving
Naam	Tekenreeks	Eindpuntnaam
Listener Type	Tekenreeks	Type groep listeners. Geldige waarden: -Unicast -Multicast - DirectConnection - HybridConnection - RelayedConnection - RelayedHttp
NumberOfListeners	Geheel getal	Aantal huidige actieve listeners