你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

枚举

项目
08/05/2023

“发现”操作用于在分层命名空间中导航，而“枚举”则用于在平面视图中列出某种类型的所有实体。枚举针对位于服务命名空间根目录的特殊保留资源集合 ($Resources) 执行。在功能方面，枚举是相对于集合地址进行的，例如，“/subscriptions”或“/rules”适用于主题的订阅和规则。

请求

你可以按照以下所示构造“枚举”请求。

方法	请求 URI	HTTP 版本
GET	https://{serviceNamespace}.servicebus.windows.net/$Resources/{resourceCollection} 或 https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions 或 https://{serviceNamespace}.servicebus.windows.net/{path}/Subscriptions/{subscription-name}/rules	HTTP/1.1

查询参数$skip和$top

枚举支持分页。可以在服务命名空间下检索一系列实体。查询参数$skip指示返回枚举时请求应跳过的条目数，并$top应返回多少个条目。

请求标头

下表介绍必需的和可选的请求标头。

请求标头	说明
授权	指定具有“管理”权限的共享访问签名 (SAS) 令牌。有关详细信息，请参阅使用共享访问签名进行服务总线身份验证。

请求正文

无。

响应

响应包括 HTTP 状态代码和一组响应标头。

响应代码

代码	说明
200	没问题。
401	未授权。请求未经授权。

注意

如果没有实体存在，则返回空源。

有关状态代码的信息，请参阅状态和错误代码。

响应标头

此操作的响应包括以下标头。该响应还可能包括其他标准 HTTP 标头。所有标准标头都符合 HTTP/1.1 协议规范。

响应标头	说明
Content-type	Content-Type：application/atom+xml;type=entry

响应正文

成功之后，会返回包含多个 Atom 条目的 Atom 源，这些 Atom 条目列出了给定命名空间中所有给定类型的可用资源。例如：

<?xml version="1.0" encoding="utf-8" ?>  
<feed xmlns='http://www.w3.org/2005/Atom'>  
  <entry>  
    <id>https://{serviceNamespace}.Windows.net/{path}</id>  
    <published>{createdTime}</published>  
    <updated>{lastUpdatedTime}</updated>  
    <link rel='self'>https://{serviceNamespace}.servicebus.Windows.net/{path}</link>  
    <content type='application/xml'>  
      {description}
    </content>  
  </entry>  
</feed>

有关 {description} 元素的可能内容，请参阅概述。

枚举

请求