全部產品
Search
文件中心

Data Transmission Service:建立消費組

更新時間:Feb 08, 2025

調用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
}

錯誤碼

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