Megosztás a következőn keresztül:

Fogyasztói csoport létrehozása

  • Cikk

Létrehoz egy új fogyasztói csoportot. Fogyasztói csoport létrehozásakor az alábbi tulajdonságokat adhatja meg a ConsumerGroupDescription elemben. Ha nincs megadva tulajdonság, az Event Hubs az adott tulajdonság alapértelmezett értékét használja. Lásd: ConsumerGroupDescription Properties ( ConsumerGroupDescription properties).

A ConsumerGroupDescription tulajdonságok alapértelmezett értéke:

Tulajdonság neve Alapértelmezett
UserMetadata (üres)

Kérés

Metódus Kérés URI-ja
PUT https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}

Kérelemfejlécek

Tekintse meg az Event Hubshoz kapcsolódó összes kérés által használt fejlécek és paraméterek gyakori paramétereit és fejléceit .

Reagálás

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

Elem neve Kötelező Típus Verzió Leírás
CreatedAt Igen, csak olvasható sztring 2014-01 A fogyasztói csoport létrehozásának pontos időpontja.
UpdatedAt Igen, csak olvasható sztring 2014-01 A fogyasztói csoport frissítésének pontos időpontja.

Válaszkódok

Code Description
201 Létrehozott.
400 Rossz kérés.
401 Engedélyezési hiba.
403 Kvóta túllépve; a fogyasztói csoport nem jött létre.
409 A megadott fogyasztói csoport 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 megadott fogyasztói csoport leírását. Ha a kérés nem sikerül, 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/consumergroups/testCG?timeout=60&api-version=2014-01 HTTP/1.1  
Authorization: SharedAccessSignature sr=https%3A%2F%2Fyour-namespace.servicebus.windows.net%2F&sig=your-sas-key&se=1455847106&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">  
      <ConsumerGroupDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
      </ConsumerGroupDescription>  
   </content>  
</entry>

Válasz

HTTP/1.1 201 Created  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Fri, 19 Feb 2016 01:52:50 GMT  
Content-Length: 776  
  
<?xml version="1.0" encoding="UTF-8"?>  
<entry xmlns="http://www.w3.org/2005/Atom">  
   <id>https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/testCG?timeout=60&api-version=2014-01</id>  
   <title type="text">testCG</title>  
   <published>2016-02-19T01:52:50Z</published>  
   <updated>2016-02-19T01:52:50Z</updated>  
   <link rel="self" href="https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/testCG?timeout=60&api-version=2014-01" />  
   <content type="application/xml">  
      <ConsumerGroupDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
         <CreatedAt>2016-02-19T01:52:50.570652Z</CreatedAt>  
         <UpdatedAt>2016-02-19T01:52:50.570652Z</UpdatedAt>  
      </ConsumerGroupDescription>  
   </content>  
</entry>