Obtener el concentrador de eventos
Recupera todos los metadatos asociados al centro de eventos especificado. Consulte Propiedades de EventHubDescription.
Solicitud
Método | URI de solicitud |
---|---|
GET | 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.
Response
La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.
Nombre del elemento | Obligatorio | Tipo | Versión | Descripción |
---|---|---|---|---|
AuthorizationRules |
Sí, solo lectura | string | 2014-01 | Reglas de autorización. |
MessageRetentionInDays | Sí, solo lectura | string | 2014-01 | Número de días para conservar los eventos de este centro de eventos. |
Status |
Sí, solo lectura | string | 2014-01 | Estado actual del centro de eventos (habilitado o deshabilitado). |
CreatedAt |
Sí, solo lectura | string | 2014-01 | Hora exacta en que se creó el centro de eventos. |
UpdatedAt |
Sí, solo lectura | string | 2014-01 | Hora exacta en que se actualizó el centro de eventos. |
PartitionCount |
Sí, solo lectura | string | 2014-01 | Número actual de particiones en el centro de eventos. |
PartitionIds |
Sí, solo lectura | string | 2014-01 | Identificadores de las particiones creadas para el centro de eventos. |
Códigos de respuesta
Código | Descripción |
---|---|
200 | Correcto. |
401 | Error de autorización. |
500 | Error interno. |
Cuerpo de la respuesta
Si la solicitud es correcta, el cuerpo de la respuesta contiene la descripción del concentrador de eventos al que se ha enviado la consulta. 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 encabezados y parámetros comunes. Por ejemplo: Authorization: Bearer <Azure AD token>
.
GET 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
ContentType: application/atom+xml;type=entry;charset=utf-8
Host: your-namespace.servicebus.windows.net
Respuesta
HTTP/1.1 200 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">
<SizeInBytes>0</SizeInBytes>
<MessageRetentionInDays>2</MessageRetentionInDays>
<AuthorizationRules></AuthorizationRules>
<Status>Active</Status>
<CreatedAt>2014-06-25T22:51:47.8656642</CreatedAt>
<UpdatedAt>2014-06-25T22:51:50.623Z</UpdatedAt>
<AccessedAt>0001-01-01T00:00:00Z</AccessedAt>
<PartitionCount>4</PartitionCount>
<EntityAvailabilityStatus>Available</EntityAvailabilityStatus>
</EventHubDescription>
</content>
</entry>