Creare un hub eventi

Articolo
08/05/2023

Crea un nuovo hub eventi. Quando si crea un hub eventi, è possibile specificare le proprietà seguenti. Se una proprietà non è specificata, Hub eventi usa il valore predefinito per questa proprietà. Vedere Proprietà eventHubDescription.

Proprietà

Oltre alle proprietà elencate di seguito, è possibile specificare proprietà aggiuntive visualizzate nella descrizione dell'hub eventi, ma ignorate dal servizio.

È necessario specificare le proprietà nell'ordine indicato di seguito. Eventuali proprietà specificate nell'ordine sbagliato saranno interpretate come proprietà utente. Questa proprietà verrà visualizzata due volte nella descrizione dell'hub eventi: una volta con il valore impostato dall'utente e una volta con il valore predefinito usato da Hub eventi.

Nome proprietà	Disponibile dalla versione API	Predefinito	Descrizione della proprietà
`MessageRetentionInDays`	2014-01	0	Descrizione
`Authorization`	2014-01	(vuoto)	Descrizione
`Status`	2014-01	Attivo	Descrizione
`UserMetadata`	2014-01	(vuoto)	Descrizione
`PartitionCount`	2014-01	16	Descrizione

Richiesta

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

Intestazioni richiesta

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

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
201	Hub eventi creato.
400	Richiesta non valida.
401	Errore di autorizzazione.
403	Quota superata. Hub eventi non creato.
409	L'hub eventi specificato esiste già oppure il percorso specificato è già occupato.
500	Errore interno.

Corpo della risposta

Se la richiesta ha esito positivo, il corpo della risposta contiene la descrizione dell'hub eventi creato. Se la richiesta ha esito negativo, il corpo contiene un codice di errore e un messaggio di errore.

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  
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">  
    </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>   
      <SizeInBytes>0</SizeInBytes>  
      <AuthorizationRules></AuthorizationRules>  
      <Status>Active</Status>  
      <PartitionCount>16</PartitionCount>  
      <EntityAvailabilityStatus>Available</EntityAvailabilityStatus>  
    </EventHubDescription>  
  </content>  
</entry>

La richiesta HTTP seguente crea un hub eventi con le impostazioni personalizzate:

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=your-sas-key&se=1403736877&skn=RootManageSharedAccessKey  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net  
  
<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>  
      <PartitionCount>8</PartitionCount>  
    </EventHubDescription>  
  </content>  
</entry>

Hub eventi restituisce la risposta seguente:

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>   
      <SizeInBytes>0</SizeInBytes>  
      <AuthorizationRules></AuthorizationRules>  
      <Status>Active</Status>  
      <PartitionCount>16</PartitionCount>  
      <EntityAvailabilityStatus>Available</EntityAvailabilityStatus>  
    </EventHubDescription>  
  </content>  
</entry>

Condividi tramite