Aktualizovat centrum událostí

Článek
08/05/2023

Aktualizace centrum událostí. Při aktualizaci centra událostí můžete změnit pouze zde uvedené vlastnosti. Při pokusu o změnu jiných vlastností dojde k chybě. Vlastnosti, které je možné změnit, ale nejsou zadané, jsou nastaveny na výchozí hodnoty.

Vlastnosti

Název vlastnosti	K dispozici od verze rozhraní API	Výchozí	Popis vlastnosti
MessageRetentionInDays	2014-01	0	MessageRetentionInDays

Žádost

Metoda	Identifikátor URI žádosti
PUT	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`

Hlavičky požadavku

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají všechny požadavky související se službou Event Hubs.

Další hlavičky požadavků

Hlavička požadavku	Povinné nebo volitelné	Description
If-Match	Vyžadováno	Pokud chcete aktualizovat centrum událostí, nastavte tuto hlavičku na *. V aktualizovaném centru událostí musíte zadat všechny hodnoty požadovaných vlastností. Všechny nezadáné hodnoty jsou nastaveny na výchozí hodnoty služby. Pokud tato hlavička chybí, volání aktualizace vrátí chybu označující, že toto centrum událostí již existuje.

Text požadavku

Položka Atom s popisem vloženým v obsahu. Příklad:

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

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Kódy odpovědí

Kód	Description
200	Úspěch.
400	Chybný požadavek.
401	Chyba autorizace.
409	Konflikt kvůli chybějící hlavičce If-Match
500	Vnitřní chyba.

Text odpovědi

Pokud je požadavek úspěšný, tělo odpovědi obsahuje popis centra událostí. Vlastnosti, které v požadavku PUT chyběly, se vrátí s výchozími hodnotami. Pokud požadavek není úspěšný, tělo obsahuje kód chyby a chybovou zprávu.

Název prvku	Description
`AuthorizationRules`	Autorizační pravidla.
`MessageRetentionInDays`	Počet dnů pro uchování událostí pro toto centrum událostí.
`Status`	Aktuální stav centra událostí (povoleno nebo zakázáno).
`CreatedAt`	Přesný čas vytvoření centra událostí
`UpdatedAt`	Přesný čas aktualizace centra událostí
`PartitionCount`	Aktuální počet oddílů v centru událostí.
`PartitionIds`	Identifikátory oddílů vytvořených pro centrum událostí.

Příklady

Žádost

Poznámka

Můžete také použít token Azure Active Directory pro autorizační hlavičku, jak je uvedeno v části Běžné parametry a hlavičky. Příklad: 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 (Odpověď)

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>