Membuat Event Hub

Artikel
07/19/2023

Membuat Pusat Aktivitas baru. Saat membuat Pusat Aktivitas, Anda dapat menentukan properti berikut. Jika properti tidak ditentukan, Azure Event Hubs menggunakan nilai default untuk properti ini. Lihat Properti EventHubDescription.

Properti

Selain properti yang tercantum sebagai berikut, Anda dapat menentukan properti tambahan yang muncul di deskripsi Pusat Aktivitas, tetapi diabaikan oleh layanan.

Anda harus menentukan properti dalam urutan yang diberikan di bawah ini. Properti apa pun yang ditentukan di luar urutan ditafsirkan sebagai properti pengguna. Properti ini akan muncul dua kali dalam deskripsi Pusat Aktivitas: sekali dengan nilai yang ditetapkan oleh pengguna, dan sekali dengan nilai default yang digunakan oleh Azure Event Hubs.

Nama Properti	Tersedia sejak versi API	Default	Deskripsi Properti
`MessageRetentionInDays`	2014-01	0	Deskripsi
`Authorization`	2014-01	(kosong)	Deskripsi
`Status`	2014-01	Aktif	Deskripsi
`UserMetadata`	2014-01	(kosong)	Deskripsi
`PartitionCount`	2014-01	16	Deskripsi

Minta

Metode	Meminta URI	Versi HTTP
PUT	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`	HTTP/1.1

Judul Permintaan

Lihat Parameter dan header umum untuk header dan parameter yang digunakan oleh semua permintaan yang terkait dengan Azure Event Hubs.

Isi Permintaan

Entri Atom dengan deskripsi yang disematkan dalam konten. Contohnya:

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

Respons

Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons.

Kode Respons

Kode	Deskripsi
201	Pusat Aktivitas dibuat.
400	Permintaan buruk.
401	Kegagalan otorisasi.
403	Kuota terlampaui; Pusat Aktivitas tidak dibuat.
409	Event Hub yang ditentukan sudah ada (atau jalur yang ditentukan sudah ditempati).
500	Kesalahan internal.

Isi Respons

Jika permintaan berhasil, isi respons berisi deskripsi Pusat Aktivitas yang dibuat. Jika permintaan tidak berhasil, isinya berisi kode kesalahan dan pesan kesalahan.

Contoh

Permintaan

Catatan

Anda juga dapat menggunakan token Azure Active Directory untuk header Otorisasi seperti yang tercantum dalam parameter dan header Umum. Misalnya: 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>

Respons

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>

Permintaan HTTP berikut membuat Pusat Aktivitas dengan pengaturan kustom:

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>

Azure Event Hubs mengembalikan respons berikut:

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>

Bagikan melalui