你当前正在访问 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 | 当前活动侦听器数 |