Event Hub aktualisieren

Artikel
08/05/2023

Updates einen Event Hub. Beim Aktualisieren eines Event Hubs können Sie nur die hier aufgeführten Eigenschaften ändern. Ein Versuch, andere Eigenschaften zu ändern, führt zu einem Fehler. Eigenschaften, die geändert werden können, aber nicht angegeben werden, werden auf ihre Standardwerte festgelegt.

Eigenschaften

Eigenschaftenname	Verfügbar seit API-Version	Standard	Eigenschaftsbeschreibung
MessageRetentionInDays	2014-01	0	MessageRetentionInDays

Anforderung

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

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.

Zusätzliche Anforderungsheader

Anforderungsheader	Erforderlich oder optional	BESCHREIBUNG
If-Match	Erforderlich	Legen Sie diesen Header auf "*" fest, um den Event Hub zu aktualisieren. Sie müssen alle gewünschten Eigenschaftswerte für den aktualisierten Event Hub bereitstellen. alle nicht angegebenen Werte werden auf die Dienststandardwerte festgelegt. Wenn dieser Header fehlt, gibt der Updateaufruf einen Fehler zurück, der angibt, dass dieser Event Hub bereits vorhanden ist.

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
200	Erfolg.
400	Ungültige Anforderung.
401	Autorisierungsfehler
409	Konflikt aufgrund fehlender If-Match-Header .
500	Interner Fehler.

Antworttext

Wenn die Anforderung erfolgreich ist, enthält der Antworttext die Event Hub-Beschreibung. Eigenschaften, die in der PUT-Anforderung gefehlt haben, werden mit Standardwerten ausgegeben. Wenn die Anforderung nicht erfolgreich ist, enthält der Text einen Fehlercode und eine Fehlermeldung.

Elementname	BESCHREIBUNG
`AuthorizationRules`	Die Autorisierungsregeln.
`MessageRetentionInDays`	Die Anzahl der Tage zum Beibehalten der Ereignisse für diesen Event Hub.
`Status`	Der aktuelle status des Event Hubs (aktiviert oder deaktiviert).
`CreatedAt`	Die genaue Zeit, zu der der Event Hub erstellt wurde.
`UpdatedAt`	Die genaue Uhrzeit, zu der der Event Hub aktualisiert wurde.
`PartitionCount`	Die aktuelle Anzahl von Partitionen auf dem Event Hub.
`PartitionIds`	Bezeichner für Partitionen, die für den Event Hub erstellt wurden.

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
If-Match: *
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">  
      <MessageRetentionInDays>3</MessageRetentionInDays>  
    </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>  
    </EventHubDescription>  
  </content>  
</entry>

Freigeben über