Továbbítók lekérése
Fontos
Ez az API 2021. 11. 01-étőlelavult, és már nem használható.
Ez a művelet számba adja a szolgáltatásnévtér nyilvánosan elérhető továbbítóvégpontjait.
Kérés
| Metódus | Kérés URI-ja | HTTP-verzió |
|---|---|---|
| GET |
https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Relays/$skip={skip}&$top={top} ahol a(z) {skip} a kihagyandó bejegyzések száma, a {top} pedig a beolvasandó bejegyzések száma. |
HTTP/1.1 |
Kérelemfejlécek
Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.
| Kérelem fejléce | Description |
|---|---|
| Névtér | Felügyeleti végpont URL-címe |
| x-ms-version | 2012-03-01 |
Vegye figyelembe, hogy a kérelemhez ügyféltanúsítvány is szükséges. Ennek a tanúsítványnak meg kell egyeznie az adott előfizetéshez feltöltött tanúsítvánnyal.
Kérelem törzse
Nincsenek.
Reagálás
A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.
Válaszkódok
| Code | Description |
|---|---|
| 200 | A továbbítási végpontok szabályzatainak lekérése sikerült. |
| 401 | Engedélyezési hiba. Akkor adja vissza, ha a felhasználó nem rendelkezik hitelesítő adatokkal a névterek továbbítóvégpont-szabályzatainak lekéréséhez. Ennek oka a felfüggesztett előfizetés lehet. |
| 404 | Az entitás nem létezik ebben a névtérben. |
| 500 | Belső/nem kezelt kivétel. |
Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.
Válaszfejlécek
A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.
| Válaszfejléc | Description |
|---|---|
| Content-Type | application/xml;type=collection;charset=utf-8 |
Válasz törzse
Az API egy XML AtomPub-dokumentumot ad vissza, amely az egyes továbbítóvégpont-szabályzatokat jelöli az alábbi elemekkel:
| Tulajdonság neve | Típus | Leírás |
|---|---|---|
| Név | Sztring | Végpont neve |
| Figyelő típusa | Sztring | A figyelők csoportjának típusa. Érvényes értékek: -Egyedi -Csoportcímes - DirectConnection - HybridConnection - RelayedConnection - Továbbítóhttp |
| NumberOfListeners | Egész szám | Aktuális aktív figyelők száma |