Ottenere gli inoltri
Importante
Questa API è obsoleta e ritirata a partire dal 11/1/2021 e non deve più essere usata.
Questa operazione enumera gli endpoint di inoltro disponibili pubblicamente in uno spazio dei nomi del servizio.
Richiesta
Metodo | URI richiesta | Versione HTTP |
---|---|---|
GET |
https://management.core.windows.net/{subscription ID}/services/ServiceBus/ Namespaces/{Namespace}/Relays/$skip={skip}&$top={top} dove {skip} è il numero di voci da ignorare e {top} è il numero di voci da recuperare. |
HTTP/1.1 |
Intestazioni richiesta
Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.
Intestazione della richiesta | Descrizione |
---|---|
Spazio dei nomi | URL endpoint di gestione |
x-ms-version | 2012-03-01 |
Tenere presente che per la richiesta è necessario anche un certificato client. Questo certificato deve corrispondere a quello caricato per la sottoscrizione specifica.
Corpo della richiesta
Nessuno.
Risposta
Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.
Codici di risposta
Codice | Descrizione |
---|---|
200 | Sono stati recuperati correttamente i criteri degli endpoint di inoltro. |
401 | Errore di autorizzazione. Restituito quando l'utente non dispone di credenziali per recuperare i criteri degli endpoint di inoltro degli spazi dei nomi. Il motivo potrebbe essere una sottoscrizione sospesa. |
404 | L'entità non è presente in questo spazio dei nomi. |
500 | Eccezione interna/non gestita. |
Per informazioni sui codici di stato, vedere Codici di stato e di errore.
Intestazioni della risposta
Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; Nella risposta possono anche essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.
Intestazione di risposta | Descrizione |
---|---|
Content-Type | application/xml;type=collection;charset=utf-8 |
Corpo della risposta
L'API restituisce un documento AtomPub XML che rappresenta ogni criterio endpoint di inoltro, con gli elementi seguenti:
Nome proprietà | Tipo | Descrizione |
---|---|---|
Nome | string | Nome dell'endpoint |
Tipo di listener | string | Gruppo di listener di tipo. Valori validi: -Unicast -Multicast - DirectConnection - HybridConnection - RelayedConnection - RelayedHttp |
NumberOfListeners | Integer | Numero di listener attivi correnti |