Hub eventi GET

  • Articolo

Recupera tutti i metadati associati all'hub eventi specificato. Vedere Proprietà eventHubDescription.

Richiesta

Metodo URI richiesta
GET https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}

Intestazioni richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati da tutte le richieste correlate a Hub eventi.

Risposta

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Nome dell'elemento Obbligatoria Tipo Versione Descrizione
AuthorizationRules Sì, di sola lettura string 2014-01 Regole di autorizzazione.
MessageRetentionInDays Sì, di sola lettura string 2014-01 Numero di giorni per conservare gli eventi per l'hub eventi.
Status Sì, di sola lettura string 2014-01 Stato corrente dell'hub eventi (abilitato o disabilitato).
CreatedAt Sì, di sola lettura string 2014-01 Ora esatta in cui è stato creato l'hub eventi.
UpdatedAt Sì, di sola lettura string 2014-01 Ora esatta dell'aggiornamento dell'hub eventi.
PartitionCount Sì, di sola lettura string 2014-01 Numero corrente di partizioni nell'hub eventi.
PartitionIds Sì, di sola lettura string 2014-01 Identificatori per le partizioni create per l'hub eventi.

Codici di risposta

Codice Descrizione
200 Operazione completata.
401 Errore di autorizzazione.
500 Errore interno.

Corpo della risposta

Se la richiesta ha esito positivo, il corpo della risposta contiene la descrizione dell'hub eventi sottoposto a query. Se la richiesta ha esito negativo, il corpo contiene un codice di errore e un messaggio di errore.

Esempio

Richiesta

Nota

È anche possibile usare un token di Azure Active Directory per l'intestazione Authorization , come indicato nelle intestazioni e parametri comuni. Ad esempio: 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

Response.

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>