Crear centro de eventos

Artículo
08/05/2023

Crea un nuevo concentrador de eventos. Al crear un concentrador de eventos, puede especificar las siguientes propiedades. Si no se especifica una propiedad, Event Hubs usa el valor predeterminado para esta propiedad. Consulte Propiedades de EventHubDescription.

Propiedades

Además de las propiedades enumeradas de la siguiente manera, puede especificar propiedades adicionales que aparecen en la descripción del centro de eventos, pero que el servicio omite.

Debe especificar las propiedades en el orden que se indica a continuación. Cualquier propiedad que se especifique fuera de este orden se interpreta como una propiedad de usuario. Esta propiedad aparecerá dos veces en la descripción del centro de eventos: una vez con el valor establecido por el usuario y una vez con el valor predeterminado que usa Event Hubs.

Nombre de la propiedad	Disponible desde la versión API	Valor predeterminado	Descripción de la propiedad
`MessageRetentionInDays`	2014-01	0	Descripción
`Authorization`	2014-01	(vacío)	Descripción
`Status`	2014-01	Activo	Descripción
`UserMetadata`	2014-01	(vacío)	Descripción
`PartitionCount`	2014-01	16	Descripción

Solicitud

Método	URI de solicitud	Versión HTTP
PUT	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`	HTTP/1.1

Encabezados de solicitud

Consulte Common parameters and headers for headers and parameters that are used by all requests related to Event Hubs (Parámetros y encabezados comunes para encabezados y parámetros que usan todas las solicitudes relacionadas con Event Hubs).

Cuerpo de la solicitud

Entrada Atom con la descripción incrustada en el contenido. Por ejemplo:

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

Response

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.

Códigos de respuesta

Código	Descripción
201	Concentrador de eventos creado.
400	Solicitud incorrecta.
401	Error de autorización.
403	Cuota superada; concentrador de eventos no creado.
409	El concentrador de eventos especificado ya existe (o la ruta especificada ya está ocupada).
500	Error interno.

Cuerpo de la respuesta

Si la solicitud se realiza correctamente, el cuerpo de la respuesta contiene la descripción del centro de eventos creado. Si la solicitud no es correcta, el cuerpo contiene un código de error y un mensaje de error.

Ejemplos

Solicitud

Nota:

También puede usar un token de Azure Active Directory para el encabezado authorization , como se indica en los parámetros y encabezados comunes. Por ejemplo: 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>

Respuesta

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 siguiente solicitud de HTTP crea un concentrador de eventos con la configuración personalizada:

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>

Event Hubs devuelve la siguiente respuesta:

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>

Compartir a través de