Obter Hub de EventosGet Event Hub

Recupera todos os metadados associados ao Hub de eventos especificado.Retrieves all metadata associated with the specified Event Hub. Consulte Propriedades de EventHubDescription.See EventHubDescription Properties.

SolicitaçãoRequest

MétodoMethod URI da solicitaçãoRequest URI
GETGET https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}

Cabeçalhos de solicitaçãoRequest Headers

Consulte os cabeçalhos e parâmetros comuns para cabeçalhos e parâmetros que são usados por todas as solicitações relacionadas aos hubs de eventos.See Common parameters and headers for headers and parameters that are used by all requests related to Event Hubs.

RespostaResponse

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.The response includes an HTTP status code, a set of response headers, and a response body.

Nome do elementoElement name ObrigatórioRequired TypeType VersãoVersion DescriçãoDescription
AuthorizationRules Sim, somente leituraYes, read-only stringstring 2014-012014-01 As regras de autorização.The authorization rules.
MessageRetentionInDaysMessageRetentionInDays Sim, somente leituraYes, read-only stringstring 2014-012014-01 O número de dias para reter os eventos para este Hub de eventos.The number of days to retain the events for this Event Hub.
Status Sim, somente leituraYes, read-only stringstring 2014-012014-01 O status atual do hub de eventos (habilitado ou desabilitado).The current status of the Event Hub (enabled or disabled).
CreatedAt Sim, somente leituraYes, read-only stringstring 2014-012014-01 A hora exata em que o Hub de eventos foi criado.The exact time the Event Hub was created.
UpdatedAt Sim, somente leituraYes, read-only stringstring 2014-012014-01 A hora exata em que o Hub de eventos foi atualizado.The exact time the Event Hub was updated.
PartitionCount Sim, somente leituraYes, read-only stringstring 2014-012014-01 O número atual de partições no Hub de eventos.The current number of partitions on the Event Hub.
PartitionIds Sim, somente leituraYes, read-only stringstring 2014-012014-01 Identificadores para partições criadas para o Hub de eventos.Identifiers for partitions created for the Event Hub.

Códigos de respostaResponse Codes

CódigoCode DescriçãoDescription
200200 Êxito.Success.
401401 Falha de autorização.Authorization failure.
500500 Erro interno.Internal error.

Corpo da respostaResponse Body

Se a solicitação for bem-sucedida, o corpo da resposta conterá a descrição do Hub de Eventos consultado.If the request is successful, the response body contains the description of the queried Event Hub. Se a solicitação não tiver êxito, o corpo conterá um código de erro e uma mensagem de erro.If the request is not successful, the body contains an error code and error message.

ExemplosExamples

SolicitaçãoRequest

Observação

Você também pode usar um token Azure Active Directory para o cabeçalho Authorization , conforme observado nos parâmetros e cabeçalhos comuns.You can also use an Azure Active Directory token for the Authorization header as noted in the Common parameters and headers. Por exemplo: Authorization: Bearer <Azure AD token>.For example: 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  

RespostaResponse

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>