Skapa händelsehubb

Artikel
07/19/2023

Skapar en ny händelsehubb. När du skapar en händelsehubb kan du ange följande egenskaper. Om en egenskap inte anges använder Event Hubs standardvärdet för den här egenskapen. Se EventHubDescription-egenskaper.

Egenskaper

Förutom de egenskaper som anges på följande sätt kan du ange ytterligare egenskaper som visas i händelsehubbens beskrivning, men som ignoreras av tjänsten.

Du måste ange egenskaperna i den ordning som anges nedan. Alla egenskaper som anges i ordning tolkas som en användaregenskap. Den här egenskapen visas två gånger i händelsehubbens beskrivning: en gång med det värde som anges av användaren och en gång med standardvärdet som används av Event Hubs.

Egenskapens namn	Tillgänglig sedan API-versionen	Standardvärde	Beskrivning av egenskap
`MessageRetentionInDays`	2014-01	0	Beskrivning
`Authorization`	2014-01	(tom)	Beskrivning
`Status`	2014-01	Aktiv	Beskrivning
`UserMetadata`	2014-01	(tom)	Beskrivning
`PartitionCount`	2014-01	16	Beskrivning

Förfrågan

Metod	URI för förfrågan	HTTP-version
PUT	`https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}`	HTTP/1.1

Rubriker för begäran

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av alla begäranden som är relaterade till Event Hubs.

Begärandetext

Atompost med beskrivningen inbäddad i innehållet. Exempel:

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

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.

Svarskoder

Kod	Description
201	Händelsehubb har skapats.
400	Felaktig begäran.
401	Auktoriseringsfel.
403	Kvoten har överskridits. Händelsehubben har inte skapats.
409	Den angivna händelsehubben finns redan (eller så är den angivna sökvägen redan upptagen).
500	Internt fel.

Svarstext

Om begäran lyckas innehåller svarstexten beskrivningen av den skapade händelsehubben. Om begäran inte lyckas innehåller brödtexten en felkod och ett felmeddelande.

Exempel

Förfrågan

Anteckning

Du kan också använda en Azure Active Directory-token för auktoriseringshuvudet enligt beskrivningen i Vanliga parametrar och rubriker. Exempel: 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

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>

Följande HTTP-begäran skapar en händelsehubb med anpassade inställningar:

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 returnerar följande svar:

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>

Dela via