Criar Hub de Eventos

Artigo
07/19/2023

Cria um novo Hub de Eventos. Ao criar um Hub de Eventos, você pode especificar as propriedades a seguir. Se uma propriedade não for especificada, os Hubs de Eventos usarão o valor padrão para essa propriedade. Consulte Propriedades eventHubDescription.

Propriedades

Além das propriedades listadas da seguinte maneira, você pode especificar propriedades adicionais que aparecem na descrição do Hub de Eventos, mas são ignoradas pelo serviço.

Você deve especificar as propriedades na ordem estabelecida abaixo. Qualquer propriedade especificada fora da ordem será interpretada como uma propriedade do usuário. Essa propriedade aparecerá duas vezes na descrição do Hub de Eventos: uma vez com o valor definido pelo usuário e uma vez com o valor padrão usado pelos Hubs de Eventos.

Nome da Propriedade	Disponível desde a API versão	Padrão	Descrição da propriedade
`MessageRetentionInDays`	2014-01	0	Descrição
`Authorization`	2014-01	(vazio)	Descrição
`Status`	2014-01	Ativo	Descrição
`UserMetadata`	2014-01	(vazio)	Descrição
`PartitionCount`	2014-01	16	Descrição

Solicitação

Método	URI da solicitação	Versão de HTTP
PUT	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`	HTTP/1.1

Cabeçalhos de solicitação

Confira Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por todas as solicitações relacionadas aos Hubs de Eventos.

Corpo da solicitação

A entrada do Atom com a descrição inserida no conteúdo. Por exemplo:

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

Resposta

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Códigos de resposta

Código	Descrição
201	Hub de Eventos criado.
400	Solicitação inválida.
401	Falha de autorização.
403	Cota excedida; Hub de Eventos não criado.
409	O Hub de Eventos especificado já existe (ou o caminho especificado já está ocupado).
500	Erro interno.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá a descrição do Hub de Eventos criado. Se a solicitação não tiver êxito, o corpo conterá um código de erro e uma mensagem de erro.

Exemplos

Solicitação

Observação

Você também pode usar um token do Azure Active Directory para o cabeçalho De autorização , conforme observado nos cabeçalhos e parâmetros comuns. Por exemplo: 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>

Resposta

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>

A solicitação HTTP a seguir cria um Hub de Eventos com configurações personalizadas:

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>

Os Hubs de Eventos retornam a seguinte resposta:

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>

Compartilhar via