Eseményközpont létrehozása

Létrehoz egy új Eseményközpontot. Eseményközpont létrehozásakor a következő tulajdonságokat adhatja meg. Ha nincs megadva tulajdonság, az Event Hubs ehhez a tulajdonsághoz az alapértelmezett értéket használja. Lásd: EventHubDescription properties (EventHubDescription properties).

Tulajdonságok

Az alábbiakban felsorolt tulajdonságok mellett további tulajdonságokat is megadhat, amelyek megjelennek az Eseményközpont leírásában, de a szolgáltatás figyelmen kívül hagyja őket.

A tulajdonságokat az alábbi sorrendben kell megadnia. A rendelésen kívül megadott tulajdonságokat a rendszer felhasználói tulajdonságként értelmezi. Ez a tulajdonság kétszer jelenik meg az Event Hub leírásában: egyszer a felhasználó által beállított értékkel, egyszer pedig az Event Hubs által használt alapértelmezett értékkel.

Tulajdonság neve	Elérhető az API-verzió óta	Alapértelmezett	Tulajdonságleírás
MessageRetentionInDays	2014-01	0	Leírás
Authorization	2014-01	(üres)	Leírás
Status	2014-01	Aktív	Leírás
UserMetadata	2014-01	(üres)	Leírás
PartitionCount	2014-01	16	Leírás

Kérés

Metódus	Kérés URI-ja	HTTP-verzió
PUT	https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}	HTTP/1.1

Kérelemfejlécek

Lásd: Az Event Hubshoz kapcsolódó összes kérés által használt fejlécek és paraméterek gyakori paraméterei és fejlécei .

Kérelem törzse

Atombejegyzés a tartalomba ágyazott leírással. Például:

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

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és egy választörzset.

Válaszkódok

Code	Description
201	Event Hub létrehozva.
400	Hibás kérés.
401	Engedélyezési hiba.
403	Kvóta túllépve; Az Event Hub nincs létrehozva.
409	A megadott Eseményközpont már létezik (vagy a megadott elérési út már foglalt).
500	Belső hiba történt.

Válasz törzse

Ha a kérés sikeres, a válasz törzse tartalmazza a létrehozott eseményközpont leírását. Ha a kérés nem sikerült, a törzs tartalmaz egy hibakódot és egy hibaüzenetet.

Példák

Kérés

Megjegyzés

Azure Active Directory-jogkivonatot is használhat az Engedélyezési fejléchez a Gyakori paraméterek és fejlécek részben leírtak szerint. Példa: 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>  

Válasz

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>  

A következő HTTP-kérés létrehoz egy eseményközpontot egyéni beállításokkal:

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>  
  

Az Event Hubs a következő választ adja vissza:

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>