Holen Sie sich Event Hubs

Artikel
08/05/2023

Ruft alle Metadaten ab, die dem angegebenen Event Hub zugeordnet sind. Weitere Informationen finden Sie unter EventHubDescription-Eigenschaften.

Anforderung

Methode	Anforderungs-URI
GET	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`

Anforderungsheader

Informationen zu Headern und Parametern, die von allen Anforderungen im Zusammenhang mit Event Hubs verwendet werden, finden Sie unter Allgemeine Parameter und Header .

Antwort

Die Antwort enthält den HTTP-Statuscode, einen Satz von Antwortheadern und einen Antworttext.

Elementname	Erforderlich	type	Version	BESCHREIBUNG
`AuthorizationRules`	Ja, schreibgeschützt	Zeichenfolge	2014-01	Die Autorisierungsregeln.
MessageRetentionInDays	Ja, schreibgeschützt	Zeichenfolge	2014-01	Die Anzahl der Tage, die die Ereignisse für diesen Event Hub beibehalten werden sollen.
`Status`	Ja, schreibgeschützt	Zeichenfolge	2014-01	Der aktuelle status des Event Hubs (aktiviert oder deaktiviert).
`CreatedAt`	Ja, schreibgeschützt	Zeichenfolge	2014-01	Die genaue Zeit, zu der der Event Hub erstellt wurde.
`UpdatedAt`	Ja, schreibgeschützt	Zeichenfolge	2014-01	Die genaue Zeit, zu der der Event Hub aktualisiert wurde.
`PartitionCount`	Ja, schreibgeschützt	Zeichenfolge	2014-01	Die aktuelle Anzahl von Partitionen im Event Hub.
`PartitionIds`	Ja, schreibgeschützt	Zeichenfolge	2014-01	Bezeichner für Partitionen, die für den Event Hub erstellt wurden.

Antwortcodes

Code	BESCHREIBUNG
200	Erfolg.
401	Autorisierungsfehler
500	Interner Fehler.

Antworttext

Wenn die Anfrage erfolgreich ist, enthält der Inhalt der Antwort die Beschreibung des abgefragten Event Hubs. Wenn die Anforderung nicht erfolgreich ausgeführt wird, enthält der Textkörper einen Fehlercode und eine Fehlernachricht.

Beispiele

Anforderung

Hinweis

Sie können auch ein Azure Active Directory-Token für den Autorisierungsheader verwenden, wie in den allgemeinen Parametern und Headern angegeben. Beispiel: 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

Antwort

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