Erstellen des Event Hubs

Artikel
07/19/2023

Erstellen einen neuen Event Hub. Beim Erstellen eines Event Hubs können nur die folgenden Eigenschaften festgelegt werden. Wenn keine Eigenschaft angegeben wird, verwendet Event Hubs den Standardwert für diese Eigenschaft. Weitere Informationen finden Sie unter EventHubDescription-Eigenschaften.

Eigenschaften

Zusätzlich zu den wie folgt aufgeführten Eigenschaften können Sie zusätzliche Eigenschaften angeben, die in der Event Hub-Beschreibung angezeigt, aber vom Dienst ignoriert werden.

Sie müssen die Eigenschaften in der unten angegebenen Reihenfolge festlegen. Jede Eigenschaft, die nicht in der Reihenfolge angegeben wurde, wird als Benutzereigenschaft interpretiert. Diese Eigenschaft wird zweimal in der Event Hub-Beschreibung angezeigt: einmal mit dem Wert, der vom Benutzer festgelegt wird, und einmal mit dem Standardwert, der von Event Hubs verwendet wird.

Eigenschaftenname	Verfügbar seit API-Version	Standard	Eigenschaftsbeschreibung
`MessageRetentionInDays`	2014-01	0	Beschreibung
`Authorization`	2014-01	(leer)	Beschreibung
`Status`	2014-01	Aktiv	Beschreibung
`UserMetadata`	2014-01	(leer)	Beschreibung
`PartitionCount`	2014-01	16	Beschreibung

Anforderung

Methode	Anforderungs-URI	HTTP-Version
PUT	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`	HTTP/1.1

Anforderungsheader

Weitere Informationen finden Sie unter Allgemeine Parameter und Header für Header und Parameter, die von allen Anforderungen im Zusammenhang mit Event Hubs verwendet werden.

Anforderungstext

Atom-Eintrag mit der im Inhalt eingebetteten Beschreibung. Beispiel:

<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    {EventHubDescription}  
  </content>  
</entry>

Antwort

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

Antwortcodes

Code	BESCHREIBUNG
201	Event Hub angelegt.
400	Ungültige Anforderung.
401	Autorisierungsfehler
403	Kontingent überschritten; Event Hub wurde nicht erstellt.
409	Der festgelegte Event Hub ist bereits vorhanden (oder der festgelegte Pfad ist bereits besetzt).
500	Interner Fehler.

Antworttext

Wenn die Anforderung erfolgreich ist, enthält der Antworttext die Beschreibung des erstellten 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>.

PUT 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  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net  
Content-Length: 264  
Expect: 100-continue  
Connection: Keep-Alive  
  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    <EventHubDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">  
    </EventHubDescription>  
  </content>  
</entry>

Antwort

HTTP/1.1 201 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">  
      <MessageRetentionInDays>3</MessageRetentionInDays>   
      <SizeInBytes>0</SizeInBytes>  
      <AuthorizationRules></AuthorizationRules>  
      <Status>Active</Status>  
      <PartitionCount>16</PartitionCount>  
      <EntityAvailabilityStatus>Available</EntityAvailabilityStatus>  
    </EventHubDescription>  
  </content>  
</entry>

Die folgende HTTP-Anforderung erstellt einen Event Hub mit benutzerdefinierten Einstellungen:

PUT 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=your-sas-key&se=1403736877&skn=RootManageSharedAccessKey  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net  
  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    <EventHubDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">  
      <MessageRetentionInDays>3</MessageRetentionInDays>  
      <PartitionCount>8</PartitionCount>  
    </EventHubDescription>  
  </content>  
</entry>

Event Hubs gibt die folgende Antwort zurück:

HTTP/1.1 201 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">  
      <MessageRetentionInDays>3</MessageRetentionInDays>   
      <SizeInBytes>0</SizeInBytes>  
      <AuthorizationRules></AuthorizationRules>  
      <Status>Active</Status>  
      <PartitionCount>16</PartitionCount>  
      <EntityAvailabilityStatus>Available</EntityAvailabilityStatus>  
    </EventHubDescription>  
  </content>  
</entry>

Freigeben über