Hämta händelsehubb

Artikel
07/19/2023

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>

Share via