Hämta händelsehubb
Hämtar alla metadata som är associerade med den angivna händelsehubben. Se EventHubDescription-egenskaper.
Förfrågan
Metod | URI för förfrågan |
---|---|
GET | https://{serviceNamespace}.servicebus.windows.net/{eventHubPath} |
Rubriker för begäran
Se Vanliga parametrar och rubriker för rubriker och parametrar som används av alla begäranden som är relaterade till Event Hubs.
Svarsåtgärder
Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.
Elementnamn | Krävs | Typ | Version | Beskrivning |
---|---|---|---|---|
AuthorizationRules |
Ja, skrivskyddad | sträng | 2014-01 | Auktoriseringsreglerna. |
MessageRetentionInDays | Ja, skrivskyddad | sträng | 2014-01 | Antalet dagar som händelser för den här händelsehubben ska behållas. |
Status |
Ja, skrivskyddad | sträng | 2014-01 | Den aktuella statusen för händelsehubben (aktiverad eller inaktiverad). |
CreatedAt |
Ja, skrivskyddad | sträng | 2014-01 | Den exakta tiden då händelsehubben skapades. |
UpdatedAt |
Ja, skrivskyddad | sträng | 2014-01 | Den exakta tiden då händelsehubben uppdaterades. |
PartitionCount |
Ja, skrivskyddad | sträng | 2014-01 | Det aktuella antalet partitioner på händelsehubben. |
PartitionIds |
Ja, skrivskyddad | sträng | 2014-01 | Identifierare för partitioner som skapats för händelsehubben. |
Svarskoder
Kod | Description |
---|---|
200 | Åtgärden lyckades. |
401 | Auktoriseringsfel. |
500 | Internt fel. |
Svarstext
Om begäran lyckas innehåller svarstexten beskrivningen av den efterfrågade händelsehubben. Om begäran inte lyckas innehåller brödtexten en felkod och ett felmeddelande.
Exempel
Förfrågan
Anteckning
Du kan också använda en Azure Active Directory-token för auktoriseringshuvudet enligt beskrivningen i Vanliga parametrar och rubriker. Exempel: 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
Response
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>