你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

创建使用者组

创建新的使用者组。 创建使用者组时，可以在 ConsumerGroupDescription 中指定以下属性。 如果未指定属性，事件中心将使用该属性的默认值。 请参阅 ConsumerGroupDescription 属性。

ConsumerGroupDescription 属性的默认值：

属性名称	默认
UserMetadata	（空）

请求

方法	请求 URI
PUT	https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}

请求标头

有关与事件中心相关的所有请求使用的标头和参数，请参阅 通用参数 和标头。

响应

响应包括 HTTP 状态代码、一组响应标头和响应正文。

元素名称	必须	类型	版本	说明
CreatedAt	是，只读	字符串	2014-01	创建使用者组的确切时间。
UpdatedAt	是，只读	字符串	2014-01	更新使用者组的确切时间。

响应代码

代码	说明
201	Created.
400	请求错误。
401	授权失败。
403	超出配额;未创建使用者组。
409	指定的使用者组已存在 (或指定的路径已被占用) 。
500	内部错误。

响应正文

如果请求成功，响应正文将包含指定使用者组的说明。 如果请求不成功，正文将包含错误代码和错误消息。

示例

请求

注意

还可以将 Azure Active Directory 令牌用于 授权 标头，如 通用参数和标头中所述。 例如：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>  
  

响应

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>