取得轉送
重要
自2021 年 11 月 1 日起，此 API 已過時且已淘汰，不應再使用。
此作業會列舉服務命名空間中公開可用的轉寄端點。
要求
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET |
https://management.core.windows.net/{subscription ID}/services/ServiceBus/ Namespaces/{Namespace}/Relays/$skip={skip} & $top={top} 其中 {skip} 是要略過的專案數，而 {top} 則是要擷取的專案數。 |
HTTP/1.1 |
要求標頭
下表描述必要的和選用的要求標頭。
| 要求標頭 | 描述 |
|---|---|
| 命名空間 | 管理端點 URL |
| x-ms-version | 2012-03-01 |
請注意，要求也需要有用戶端憑證。 此憑證必須符合您針對該特殊訂閱所上傳的憑證。
要求本文
無。
回應
回應包括 HTTP 狀態碼和一組回應標頭。
回應碼
| 程式碼 | 描述 |
|---|---|
| 200 | 已成功擷取轉寄端點原則。 |
| 401 | 授權失敗。 當使用者沒有認證來擷取命名空間轉送端點原則時傳回。 這可能是因為暫停訂閱所導致。 |
| 404 | 實體不存在於此命名空間下。 |
| 500 | 內部/未處理的例外狀況。 |
如需狀態碼的相關資訊，請參閱 狀態和錯誤碼。
回應標頭
這項作業的回應包括下列標頭。 回應也可能包括其他標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協定規格。
| 回應標頭 | Description |
|---|---|
| Content-Type | application/xml;type=collection;charset=utf-8 |
回應本文
API 會傳回代表每個轉送端點原則的 XML AtomPub 檔，其中包含下列元素：
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| 名稱 | String | 端點名稱 |
| 接聽程式類型 | String | 接聽程式類型的群組。 有效值： -播 -組 播 - DirectConnection - HybridConnection - RelayedConnection - RelayedHttp |
| NumberOfListeners | 整數 | 目前作用中的接聽程式數目 |