調用CreateConsumerGroup介面為資料訂閱執行個體新增消費組。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
| 名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
| Action | String | 是 | CreateConsumerGroup | 系統規定參數,取值:CreateConsumerGroup。 |
| ConsumerGroupName | String | 是 | 測試訂閱組 | 消費組名稱,不超過128個字元。建議配置具有業務意義的名稱,便於後續識別。 |
| ConsumerGroupPassword | String | 是 | Test123456 | 消費組帳號的密碼。
|
| ConsumerGroupUserName | String | 是 | dtstest | 消費組的帳號。
|
| 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
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。