你当前正在访问 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>