Tworzenie centrum zdarzeń

Artykuł
07/19/2023

Tworzy nowe centrum zdarzeń. Podczas tworzenia centrum zdarzeń można określić następujące właściwości. Jeśli właściwość nie jest określona, usługa Event Hubs używa wartości domyślnej dla tej właściwości. Zobacz Właściwości usługi EventHubDescription.

Właściwości

Oprócz właściwości wymienionych w następujący sposób można określić dodatkowe właściwości wyświetlane w opisie centrum zdarzeń, ale są ignorowane przez usługę.

Musisz określić właściwości w kolejności podanej poniżej. Każda właściwość określona poza kolejnością jest interpretowana jako właściwość użytkownika. Ta właściwość będzie wyświetlana dwa razy w opisie centrum zdarzeń: raz z wartością ustawioną przez użytkownika i raz z wartością domyślną używaną przez usługę Event Hubs.

Nazwa właściwości	Dostępna od wersji interfejsu API	Domyślny	Opis właściwości
`MessageRetentionInDays`	2014-01	0	Opis
`Authorization`	2014-01	(puste)	Opis
`Status`	2014-01	Aktywna	Opis
`UserMetadata`	2014-01	(puste)	Opis
`PartitionCount`	2014-01	16	Opis

Żądanie

Metoda	Identyfikator URI żądania	Wersja protokołu HTTP
PUT	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`	HTTP/1.1

Nagłówki żądań

Zobacz Typowe parametry i nagłówki nagłówków i parametrów , które są używane przez wszystkie żądania związane z usługą Event Hubs.

Treść żądania

Wpis Atom z opisem osadzonym w zawartości. Przykład:

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

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kody odpowiedzi

Kod	Opis
201	Centrum zdarzeń zostało utworzone.
400	Nieprawidłowe żądanie.
401	Niepowodzenie autoryzacji.
403	Przekroczono limit przydziału; Centrum zdarzeń nie zostało utworzone.
409	Określone centrum zdarzeń już istnieje (lub określona ścieżka jest już zajęta).
500	Błąd wewnętrzny.

Treść odpowiedzi

Jeśli żądanie zakończy się pomyślnie, treść odpowiedzi zawiera opis utworzonego centrum zdarzeń. Jeśli żądanie nie powiedzie się, treść zawiera kod błędu i komunikat o błędzie.

Przykłady

Żądanie

Uwaga

Możesz również użyć tokenu usługi Azure Active Directory dla nagłówka autoryzacji , jak opisano w sekcji Common parameters and headers (Typowe parametry i nagłówki). Na przykład: 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>

Odpowiedź

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>

Następujące żądanie HTTP tworzy centrum zdarzeń z ustawieniami niestandardowymi:

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>

Usługa Event Hubs zwraca następującą odpowiedź:

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>

Udostępnij za pośrednictwem