你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
获取中继
重要
此 API 已 过时，自2021 年 11 月 1 日停用，不应再使用。
此操作枚举服务命名空间中公开可用的中继终结点。
请求
| 方法 | 请求 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 协议规范。
| 响应标头 | 说明 |
|---|---|
| Content-Type | application/xml;type=collection;charset=utf-8 |
响应正文
API 返回一个 XML AtomPub 文档，该文档表示每个中继终结点策略，其中包含以下元素：
| 属性名称 | 类型 | 说明 |
|---|---|---|
| 名称 | 字符串 | 终结点名称 |
| 侦听器类型 | 字符串 | 侦听器类型的组。 有效值： -播 -组 播 - DirectConnection - HybridConnection - RelayedConnection - RelayedHttp |
| NumberOfListeners | Integer | 当前活动侦听器数 |