Actualizar concentrador de eventos

Artículo
08/05/2023

Novedades un centro de eventos. Al actualizar un centro de eventos, solo puede cambiar las propiedades enumeradas aquí. Un intento de cambiar cualquier otra propiedad produce un error. Las propiedades que se pueden cambiar, pero que no se especifican, se establecen en sus valores predeterminados.

Propiedades

Nombre de la propiedad	Disponible desde la versión API	Valor predeterminado	Descripción de la propiedad
MessageRetentionInDays	2014-01	0	MessageRetentionInDays

Solicitud

Método	URI de la solicitud
PUT	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`

Encabezados de solicitud

Consulte Parámetros y encabezados comunes para encabezados y parámetros que usan todas las solicitudes relacionadas con Event Hubs.

Encabezados de solicitud adicionales

Encabezado de la solicitud	Obligatorio u opcional	Descripción
If-Match	Obligatorio	Establezca este encabezado en "*" para actualizar el centro de eventos. Debe proporcionar todos los valores de propiedad deseados en el centro de eventos actualizado; los valores no proporcionados se establecen en los valores predeterminados del servicio. Si falta este encabezado, la llamada de actualización devuelve un error que indica que este centro de eventos ya existe.

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
200	Correcto.
400	Solicitud incorrecta.
401	Error de autorización.
409	Conflicto debido a la falta de encabezado If-Match .
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. Las propiedades que se perdieron en la solicitud PUT se devuelven con los valores predeterminados. Si la solicitud no se realiza correctamente, el cuerpo contiene un código de error y un mensaje de error.

Nombre del elemento	Descripción
`AuthorizationRules`	Reglas de autorización.
`MessageRetentionInDays`	Número de días para conservar los eventos de este centro de eventos.
`Status`	Estado actual del centro de eventos (habilitado o deshabilitado).
`CreatedAt`	Hora exacta en que se creó el centro de eventos.
`UpdatedAt`	Hora exacta en que se actualizó el centro de eventos.
`PartitionCount`	Número actual de particiones en el centro de eventos.
`PartitionIds`	Identificadores de las particiones creadas para el centro de eventos.

Ejemplos

Solicitud

Nota:

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

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>  
    </EventHubDescription>  
  </content>  
</entry>

Compartir a través de