Aggiornamento dell'hub eventi

Articolo
08/05/2023

Aggiornamenti un hub eventi. Quando si aggiorna un hub eventi, è possibile modificare solo le proprietà elencate qui. Un tentativo di modificare qualsiasi altra proprietà genera un errore. Le proprietà che possono essere modificate ma non specificate sono impostate su valori predefiniti.

Proprietà

Nome proprietà	Disponibile dalla versione API	Predefinito	Descrizione della proprietà
MessageRetentionInDays	2014-01	0	MessageRetentionInDays

Richiesta

Metodo	URI richiesta
PUT	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`

Intestazioni richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati da tutte le richieste correlate a Hub eventi.

Intestazioni di richiesta aggiuntive

Intestazione della richiesta	Obbligatorio o facoltativo	Descrizione
If-Match	Necessario	Impostare questa intestazione su "*" per aggiornare l'hub eventi. È necessario specificare tutti i valori di proprietà desiderati nell'hub eventi aggiornato; i valori non specificati sono impostati sui valori predefiniti del servizio. Se questa intestazione è mancante, la chiamata di aggiornamento restituisce un errore che indica che l'hub eventi esiste già.

Corpo della richiesta

Voce Atom con la descrizione incorporata nel contenuto. Ad esempio:

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

Risposta

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Codici di risposta

Codice	Descrizione
200	Operazione completata.
400	Richiesta non valida.
401	Errore di autorizzazione.
409	Conflitto a causa dell'intestazione If-Match mancante.
500	Errore interno.

Corpo della risposta

Se la richiesta ha esito positivo, il corpo della risposta contiene la descrizione dell'hub eventi. Le proprietà mancanti dalla richiesta PUT saranno restituite con i valori predefiniti. Se la richiesta non ha esito positivo, il corpo contiene un codice di errore e un messaggio di errore.

Nome dell'elemento	Descrizione
`AuthorizationRules`	Regole di autorizzazione.
`MessageRetentionInDays`	Numero di giorni per conservare gli eventi per questo hub eventi.
`Status`	Stato corrente dell'hub eventi (abilitato o disabilitato).
`CreatedAt`	Ora esatta in cui è stato creato l'hub eventi.
`UpdatedAt`	Ora esatta dell'aggiornamento dell'hub eventi.
`PartitionCount`	Numero corrente di partizioni nell'hub eventi.
`PartitionIds`	Identificatori per le partizioni create per l'hub eventi.

Esempio

Richiesta

Nota

È anche possibile usare un token di Azure Active Directory per l'intestazione Di autorizzazione come indicato nei parametri e nelle intestazioni comuni. Ad esempio: 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>

Condividi tramite