Lista de Hubs de Eventos

Artigo
02/12/2024

Recupera todos os metadados associados a todos os Hubs de Eventos em um namespace dos Hubs de Eventos especificado. Consulte Propriedades eventHubDescription.

Solicitação

Método	URI da solicitação
GET	`https://{servicebusNamespace}.servicebus.windows.net/$Resources/Eventhubs`

Cabeçalhos de solicitação

Confira Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros 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 esse 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 de todos os hHubs de evento no namespace dos Hubs de Eventos consultados. Se a solicitação não for bem-sucedida, 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 cabeçalhos e parâmetros comuns. Por exemplo: Authorization: Bearer <Azure AD token>.

GET https://your-namespace.servicebus.windows.net/ $Resources/Eventhubs?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

Resposta

HTTP/1.1 200 OK  
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  
  
<?xml version="1.0" encoding="UTF-8"?>  
<feed xmlns="http://www.w3.org/2005/Atom">  
   <title type="text">EventHubs</title>  
   <id>https://your-namespace.servicebus.windows.net/$Resources/Eventhubs?timeout=60&api-version=2014-01</id>  
   <updated>2016-02-19T22:56:38Z</updated>  
   <link rel="self" href="https://your-namespace.servicebus.windows.net/$Resources/Eventhubs?timeout=60&api-version=2014-01" />  
   <entry xml:base="https://your-namespace.servicebus.windows.net/$Resources/Eventhubs?timeout=60&api-version=2014-01">  
      <id>https://your-namespace.servicebus.windows.net/your-event-hub?api-version=2014-01</id>  
      <title type="text">your-event-hub</title>  
      <published>2015-09-09T20:30:51Z</published>  
      <updated>2015-09-09T21:16:12Z</updated>  
      <author>  
         <name>your-namespace</name>  
      </author>  
      <link rel="self" href="../your-event-hub?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>1</MessageRetentionInDays>  
            <AuthorizationRules>  
               <AuthorizationRule i:type="SharedAccessAuthorizationRule">  
                  <ClaimType>SharedAccessKey</ClaimType>  
                  <ClaimValue>None</ClaimValue>  
                  <Rights>  
                     <AccessRights>Send</AccessRights>  
                  </Rights>  
                  <CreatedTime>2015-09-09T21:16:11.7216934Z</CreatedTime>  
                  <ModifiedTime>2015-09-09T21:16:11.7216934Z</ModifiedTime>  
                  <KeyName>send</KeyName>  
                  <PrimaryKey>your-primary-key</PrimaryKey>  
                  <SecondaryKey>your-secondary-key</SecondaryKey>  
               </AuthorizationRule>  
               <AuthorizationRule i:type="SharedAccessAuthorizationRule">  
                  <ClaimType>SharedAccessKey</ClaimType>  
                  <ClaimValue>None</ClaimValue>  
                  <Rights>  
                     <AccessRights>Listen</AccessRights>  
                  </Rights>  
                  <CreatedTime>2015-09-09T21:16:11.7216934Z</CreatedTime>  
                  <ModifiedTime>2015-09-09T21:16:11.7216934Z</ModifiedTime>  
                  <KeyName>listen</KeyName>  
                  <PrimaryKey>your-primary-key</PrimaryKey>  
                  <SecondaryKey>your-secondary-key</SecondaryKey>  
               </AuthorizationRule>  
               <AuthorizationRule i:type="SharedAccessAuthorizationRule">  
                  <ClaimType>SharedAccessKey</ClaimType>  
                  <ClaimValue>None</ClaimValue>  
                  <Rights>  
                     <AccessRights>Manage</AccessRights>  
                     <AccessRights>Send</AccessRights>  
                     <AccessRights>Listen</AccessRights>  
                  </Rights>  
                  <CreatedTime>2015-09-09T21:16:11.7216934Z</CreatedTime>  
                  <ModifiedTime>2015-09-09T21:16:11.7216934Z</ModifiedTime>  
                  <KeyName>manage</KeyName>  
                  <PrimaryKey>your-primary-key</PrimaryKey>  
                  <SecondaryKey>your-secondary-key</SecondaryKey>  
               </AuthorizationRule>  
            </AuthorizationRules>  
            <Status>Active</Status>  
            <CreatedAt>2015-09-09T20:30:51.083</CreatedAt>  
            <UpdatedAt>2015-09-09T21:16:12.057</UpdatedAt>  
            <PartitionCount>2</PartitionCount>  
            <PartitionIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">  
               <d2p1:string>0</d2p1:string>  
               <d2p1:string>1</d2p1:string>  
            </PartitionIds>  
         </EventHubDescription>  
      </content>  
   </entry>  
</feed>

Compartilhar via