Vytvoření centra událostí

Článek
08/05/2023

Vytvoří nové centrum událostí. Při vytváření centra událostí můžete zadat následující vlastnosti. Pokud není zadána vlastnost, použije služba Event Hubs výchozí hodnotu pro tuto vlastnost. Viz EventHubDescription – vlastnosti.

Vlastnosti

Kromě následujících vlastností můžete zadat další vlastnosti, které se zobrazí v popisu centra událostí, ale služba je ignoruje.

Musíte zadat vlastnosti v pořadí uvedeném níže. Jakákoli vlastnost, která je zadána mimo pořadí, je interpretována jako vlastnost uživatele. Tato vlastnost se v popisu centra událostí zobrazí dvakrát: jednou s hodnotou nastavenou uživatelem a jednou s výchozí hodnotou, kterou používá služba Event Hubs.

Název vlastnosti	K dispozici od verze rozhraní API	Výchozí	Popis vlastnosti
`MessageRetentionInDays`	2014-01	0	Popis
`Authorization`	2014-01	(prázdné)	Popis
`Status`	2014-01	Aktivní	Popis
`UserMetadata`	2014-01	(prázdné)	Popis
`PartitionCount`	2014-01	16	Popis

Žádost

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
PUT	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`	HTTP/1.1

Hlavičky požadavku

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které používají všechny požadavky související se službou Event Hubs.

Text požadavku

Položka Atom s popisem vloženým v obsahu. Příklad:

<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    {EventHubDescription}  
  </content>  
</entry>

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Kódy odpovědí

Kód	Description
201	Centrum událostí se vytvořilo.
400	Chybný požadavek.
401	Chyba autorizace.
403	Překročení kvóty; Centrum událostí se nevytvořilo.
409	Zadané centrum událostí již existuje (nebo je zadaná cesta již obsazená).
500	Vnitřní chyba.

Text odpovědi

Pokud je požadavek úspěšný, tělo odpovědi obsahuje popis vytvořeného centra událostí. Pokud požadavek není úspěšný, tělo obsahuje kód chyby a chybovou zprávu.

Příklady

Žádost

Poznámka

Můžete také použít token Azure Active Directory pro autorizační hlavičku, jak je uvedeno v části Běžné parametry a hlavičky. Příklad: Authorization: Bearer <Azure AD token>.

PUT 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  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net  
Content-Length: 264  
Expect: 100-continue  
Connection: Keep-Alive  
  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    <EventHubDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">  
    </EventHubDescription>  
  </content>  
</entry>

Response (Odpověď)

HTTP/1.1 201 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">  
      <MessageRetentionInDays>3</MessageRetentionInDays>   
      <SizeInBytes>0</SizeInBytes>  
      <AuthorizationRules></AuthorizationRules>  
      <Status>Active</Status>  
      <PartitionCount>16</PartitionCount>  
      <EntityAvailabilityStatus>Available</EntityAvailabilityStatus>  
    </EventHubDescription>  
  </content>  
</entry>

Následující požadavek HTTP vytvoří centrum událostí s vlastním nastavením:

PUT 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=your-sas-key&se=1403736877&skn=RootManageSharedAccessKey  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net  
  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    <EventHubDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">  
      <MessageRetentionInDays>3</MessageRetentionInDays>  
      <PartitionCount>8</PartitionCount>  
    </EventHubDescription>  
  </content>  
</entry>

Event Hubs vrátí následující odpověď:

HTTP/1.1 201 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">  
      <MessageRetentionInDays>3</MessageRetentionInDays>   
      <SizeInBytes>0</SizeInBytes>  
      <AuthorizationRules></AuthorizationRules>  
      <Status>Active</Status>  
      <PartitionCount>16</PartitionCount>  
      <EntityAvailabilityStatus>Available</EntityAvailabilityStatus>  
    </EventHubDescription>  
  </content>  
</entry>

Sdílet prostřednictvím