Uppdatera händelsehubb

Artikel
08/05/2023

Uppdateringar en händelsehubb. När du uppdaterar en händelsehubb kan du bara ändra egenskaperna som anges här. Ett försök att ändra andra egenskaper resulterar i ett fel. Egenskaper som kan ändras men inte anges anges till deras standardvärden.

Egenskaper

Egenskapens namn	Tillgänglig sedan API-version	Standardvärde	Beskrivning av egenskap
MessageRetentionInDays	2014-01	0	MessageRetentionInDays

Förfrågan

Metod	URI för förfrågan
PUT	`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.

Ytterligare begärandehuvuden

Begärandehuvud	Obligatoriskt eller valfritt	Description
If-Match	Obligatorisk	Ställ in det här huvudet på "*" för att uppdatera händelsehubben. Du måste ange alla önskade egenskapsvärden på den uppdaterade händelsehubben. värden som inte anges anges till tjänstens standardvärden. Om det här huvudet saknas returnerar uppdateringsanropet ett fel som anger att den här händelsehubben redan finns.

Begärandetext

Atompost med beskrivningen inbäddad i innehållet. Exempel:

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

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.

Svarskoder

Kod	Description
200	Åtgärden lyckades.
400	Felaktig begäran.
401	Auktoriseringsfel.
409	Konflikt på grund av att If-Match-huvudet saknas.
500	Internt fel.

Svarstext

Om begäran lyckas innehåller svarstexten händelsehubbens beskrivning. Egenskaper som saknades i PUT-begäran returneras med standardvärden. Om begäran inte lyckas innehåller brödtexten en felkod och ett felmeddelande.

Elementnamn	Description
`AuthorizationRules`	Auktoriseringsreglerna.
`MessageRetentionInDays`	Antalet dagar som händelser ska behållas för den här händelsehubben.
`Status`	Händelsehubbens aktuella status (aktiverad eller inaktiverad).
`CreatedAt`	Exakt när händelsehubben skapades.
`UpdatedAt`	Den exakta tiden som händelsehubben uppdaterades.
`PartitionCount`	Det aktuella antalet partitioner på händelsehubben.
`PartitionIds`	Identifierare för partitioner som skapats för händelsehubben.

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>.

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>

Response

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>

Dela via