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

获取事件中心

检索与指定事件中心关联的所有元数据。 请参阅 EventHubDescription 属性

请求

方法 请求 URI
GET https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}

请求标头

有关所有与事件中心相关的请求使用的标头和参数,请参阅 通用参数和标头

响应

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

元素名称 必须 类型 版本 说明
AuthorizationRules 是,只读 字符串 2014-01 授权规则。
MessageRetentionInDays 是,只读 字符串 2014-01 要保留此事件中心的事件的天数。
Status 是,只读 字符串 2014-01 事件中心的当前状态 (启用或禁用) 。
CreatedAt 是,只读 string 2014-01 创建事件中心的确切时间。
UpdatedAt 是,只读 字符串 2014-01 事件中心的确切更新时间。
PartitionCount 是,只读 字符串 2014-01 事件中心上的当前分区数。
PartitionIds 是,只读 string 2014-01 为事件中心创建的分区的标识符。

响应代码

代码 说明
200 成功。
401 授权失败。
500 内部错误。

响应正文

如果请求成功,则响应正文包含所查询的事件中心的说明。 如果请求不成功,则正文包含错误代码和错误消息。

示例

请求

注意

还可以将 Azure Active Directory 令牌用于 授权 标头,如 通用参数和标头中所述。 例如:Authorization: Bearer <Azure AD token>

GET https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace.servicebus.windows.net&sig=tYu8qdH563Pc96Lky0SFs5PhbGnljF7mLYQwCZmk9M0%3d&se=1403736877&skn=RootManageSharedAccessKey  
ContentType: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net  

响应

HTTP/1.1 200 Created  
Transfer-Encoding: chunked  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Wed, 25 Jun 2014 22:43:27 GMT  
  
<entry xmlns="http://www.w3.org/2005/Atom">  
  <id>https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01</id>  
  <title type="text">your-event-hub</title>  
  <published>2014-06-25T22:43:16Z</published>  
  <updated>2014-06-25T22:43:27Z</updated>  
  <author>  
    <name>your-namespace</name>  
  </author>  
  <link rel="self" href="https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01"/>  
  <content type="application/xml">  
    <EventHubDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
      <SizeInBytes>0</SizeInBytes>  
      <MessageRetentionInDays>2</MessageRetentionInDays>  
      <AuthorizationRules></AuthorizationRules>  
      <Status>Active</Status>  
      <CreatedAt>2014-06-25T22:51:47.8656642</CreatedAt>  
      <UpdatedAt>2014-06-25T22:51:50.623Z</UpdatedAt>  
      <AccessedAt>0001-01-01T00:00:00Z</AccessedAt>  
      <PartitionCount>4</PartitionCount>  
      <EntityAvailabilityStatus>Available</EntityAvailabilityStatus>  
    </EventHubDescription>  
  </content>  
</entry>