Share via


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