Aktualizowanie centrum zdarzeń

Artykuł
07/19/2023

Aktualizacje centrum zdarzeń. Podczas aktualizowania centrum zdarzeń można zmienić tylko właściwości wymienione tutaj. Próba zmiany innych właściwości powoduje wystąpienie błędu. Właściwości, które można zmienić, ale nie zostały określone, są ustawione na ich wartości domyślne.

Właściwości

Nazwa właściwości	Dostępna od wersji interfejsu API	Domyślny	Opis właściwości
MessageRetentionInDays	2014-01	0	MessageRetentionInDays

Żądanie

Metoda	Identyfikator URI żądania
PUT	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`

Nagłówki żądań

Zobacz Typowe parametry i nagłówki nagłówków i parametrów , które są używane przez wszystkie żądania związane z usługą Event Hubs.

Dodatkowe nagłówki żądań

Nagłówek żądania	Wymagane lub opcjonalne	Opis
If-Match	Wymagane	Ustaw ten nagłówek na "*", aby zaktualizować centrum zdarzeń. Musisz podać wszystkie żądane wartości właściwości w zaktualizowanym centrum zdarzeń; wartości, które nie zostały podane, są ustawione na wartości domyślne usługi. Jeśli brakuje tego nagłówka, wywołanie aktualizacji zwraca błąd wskazujący, że to centrum zdarzeń już istnieje.

Treść żądania

Wpis Atom z opisem osadzonym w zawartości. Przykład:

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

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kody odpowiedzi

Kod	Opis
200	Powodzenie.
400	Nieprawidłowe żądanie.
401	Niepowodzenie autoryzacji.
409	Konflikt z powodu braku nagłówka If-Match .
500	Błąd wewnętrzny.

Treść odpowiedzi

Jeśli żądanie zakończy się pomyślnie, treść odpowiedzi zawiera opis centrum zdarzeń. Właściwości, których brakuje w żądaniu PUT, są zwracane z wartościami domyślnymi. Jeśli żądanie nie powiedzie się, treść zawiera kod błędu i komunikat o błędzie.

Nazwa elementu	Opis
`AuthorizationRules`	Reguły autoryzacji.
`MessageRetentionInDays`	Liczba dni przechowywania zdarzeń dla tego centrum zdarzeń.
`Status`	Bieżący stan centrum zdarzeń (włączony lub wyłączony).
`CreatedAt`	Dokładny czas utworzenia centrum zdarzeń.
`UpdatedAt`	Dokładny czas aktualizacji centrum zdarzeń.
`PartitionCount`	Bieżąca liczba partycji w centrum zdarzeń.
`PartitionIds`	Identyfikatory partycji utworzonych dla centrum zdarzeń.

Przykłady

Żądanie

Uwaga

Możesz również użyć tokenu usługi Azure Active Directory dla nagłówka autoryzacji , jak opisano w sekcji Common parameters and headers (Typowe parametry i nagłówki). Na przykład: 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>

Odpowiedź

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>

Udostępnij za pośrednictwem