Obter Hub de Eventos

  • Artigo

Recupera todos os metadados associados ao Hub de Eventos especificado. Consulte Propriedades eventHubDescription.

Solicitação

Método URI da solicitação
GET https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}

Cabeçalhos de solicitação

Consulte Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros que são usados por todas as solicitações relacionadas aos Hubs de Eventos.

Resposta

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

Nome do elemento Obrigatório Tipo Versão Descrição
AuthorizationRules Sim, somente leitura string 2014-01 As regras de autorização.
MessageRetentionInDays Sim, somente leitura string 2014-01 O número de dias para reter os eventos para este Hub de Eventos.
Status Sim, somente leitura string 2014-01 O status atual do Hub de Eventos (habilitado ou desabilitado).
CreatedAt Sim, somente leitura string 2014-01 A hora exata em que o Hub de Eventos foi criado.
UpdatedAt Sim, somente leitura string 2014-01 A hora exata em que o Hub de Eventos foi atualizado.
PartitionCount Sim, somente leitura string 2014-01 O número atual de partições no Hub de Eventos.
PartitionIds Sim, somente leitura string 2014-01 Identificadores para partições criadas para o Hub de Eventos.

Códigos de resposta

Código Descrição
200 Êxito.
401 Falha de autorização.
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 consultado. 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 parâmetros e cabeçalhos Comuns. Por exemplo: 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

Resposta

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>