Freigeben über


Holen Sie sich Event Hubs

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>