調用CreateConsumerGroup接口為數據訂閱實例新增消費組。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 CreateConsumerGroup

系統規定參數，取值：CreateConsumerGroup。

ConsumerGroupName String 是 測試訂閱組

消費組名稱，不超過128個字符。建議配置具有業務意義的名稱，便于后續識別。
ConsumerGroupPassword String 是 Test123456

消費組賬號的密碼。

  • 由大寫字母、小寫字母、數字、特殊字符中的任意兩種或兩種以上組成。
  • 密碼長度為8~32個字符。
ConsumerGroupUserName String 是 dtstest

消費組的賬號。

  • 由大寫字母、小寫字母、數字、下劃線中的任意一種或多種組成。
  • 最長16個字符。
SubscriptionInstanceId String 是 dtsg2m10r1x15a****

數據訂閱實例ID，可以通過調用DescribeSubscriptionInstances接口查詢。
RegionId String 否 cn-hangzhou

數據訂閱實例所在地域的ID，詳情請參見支持的地域列表。

AccountId String 否 12323344****

阿里云主賬號ID，無需設置，該參數即將下線。

返回數據

名稱 類型 示例值 描述
ConsumerGroupID String dtswc411cg617p****

消費組ID。
ErrCode String InternalError

調用出錯時返回的錯誤碼。
ErrMessage String The request processing has failed due to some unknown error.

調用出錯時返回的錯誤信息。
RequestId String 6063641E-BAD1-4BA7-B70B-26FFFD18****

請求ID。
Success String true

請求是否成功。

示例

請求示例

http(s)://dts.aliyuncs.com/?Action=CreateConsumerGroup
&ConsumerGroupName=測試訂閱組
&ConsumerGroupPassword=Test123456
&ConsumerGroupUserName=dtstest
&SubscriptionInstanceId=dtsg2m10r1x15a****
&<公共請求參數>

正常返回示例

XML格式 

<CreateConsumerGroupResponse>
      <ConsumerGroupID>dtswc411cg617p****</ConsumerGroupID>
      <RequestId>6063641E-BAD1-4BA7-B70B-26FFFD18****</RequestId>
      <Success>true</Success>
</CreateConsumerGroupResponse>

JSON格式 

{
	"ConsumerGroupID": "dtswc411cg617p****",
	"RequestId": "6063641E-BAD1-4BA7-B70B-26FFFD18****",
	"Success": true
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。