Pobieranie przekaźników
Ważne
Ten interfejs API jest przestarzały i wycofany od 11.1.2021 r. i nie powinien być już używany.
Ta operacja wylicza publicznie dostępne punkty końcowe przekaźnika w przestrzeni nazw usługi.
Żądanie
| Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
|---|---|---|
| GET |
https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Relays/$skip={skip}&$top={top} gdzie {skip} to liczba wpisów do pominięcia, a {top} to liczba wpisów do pobrania. |
HTTP/1.1 |
Nagłówki żądań
W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.
| Nagłówek żądania | Opis |
|---|---|
| Przestrzeń nazw | Adres URL punktu końcowego zarządzania |
| x-ms-version | 2012-03-01 |
Należy pamiętać, że żądanie wymaga również certyfikatu klienta. Ten certyfikat musi być zgodny z certyfikatem przekazanym dla tej konkretnej subskrypcji.
Treść żądania
Brak.
Reakcja
Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.
Kody odpowiedzi
| Kod | Opis |
|---|---|
| 200 | Pomyślnie pobrano zasady punktów końcowych przekaźnika. |
| 401 | Niepowodzenie autoryzacji. Zwracane, gdy użytkownik nie ma poświadczeń do pobierania zasad przekazywania punktów końcowych przestrzeni nazw. Może to być spowodowane zawieszoną subskrypcją. |
| 404 | Jednostka nie istnieje w tej przestrzeni nazw. |
| 500 | Wyjątek wewnętrzny/nieobsługiwany. |
Aby uzyskać informacje o kodach stanu, zobacz Kody stanu i błędów.
Nagłówki odpowiedzi
Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.
| Nagłówek odpowiedzi | Opis |
|---|---|
| Content-Type | application/xml;type=collection;charset=utf-8 |
Treść odpowiedzi
Interfejs API zwraca dokument XML AtomPub reprezentujący poszczególne zasady punktu końcowego przekaźnika z następującymi elementami:
| Nazwa właściwości | Typ | Opis |
|---|---|---|
| Nazwa | Ciąg | Nazwa punktu końcowego |
| Typ odbiornika | Ciąg | Typ grupy odbiorników. Prawidłowe wartości: -Emisji pojedynczej -Multiemisji - DirectConnection - Połączenie hybrydowe - RelayedConnection - RelayedHttp |
| NumberOfListeners | Liczba całkowita | Liczba bieżących aktywnych odbiorników |