Cria um grupo de consumidores para uma tarefa de rastreamento de alterações. Clientes downstream podem usar esse grupo para consumir dados rastreados.
Depuração
Parâmetros da solicitação
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| Action | String | Sim | CreateConsumerChannel |
Operação a ser executada. Defina o valor como CreateConsumerChannel. |
| ConsumerGroupName | String | Sim | Consumer Group A |
Nome do grupo de consumidores. O limite é de 128 caracteres. Use um nome descritivo para facilitar a identificação. |
| ConsumerGroupPassword | String | Sim | Test123456 |
Senha do grupo de consumidores.
|
| ConsumerGroupUserName | String | Sim | dtstest |
Nome de usuário do grupo de consumidores.
|
| RegionId | String | Sim | cn-hangzhou |
ID da região onde reside a instância de rastreamento de alterações. Para mais informações, consulte Lista de regiões suportadas. |
| DtsInstanceId | String | Não | dtsboss6pn1w****** |
ID da instância de rastreamento de alterações. Chame a operação DescribeDtsJobs para consultar o ID da instância. Nota Especifique pelo menos um dos parâmetros DtsInstanceId ou DtsJobId. |
| DtsJobId | String | Não | boss6pn1w****** |
ID da tarefa de rastreamento de alterações. Chame a operação DescribeDtsJobs para obter o ID da tarefa. Nota Especifique pelo menos um dos parâmetros DtsInstanceId ou DtsJobId. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
ConsumerGroupID |
String |
dtsor2y66j4219**** |
ID do grupo de consumidores. Defina este parâmetro no cliente downstream ao consumir dados rastreados. |
|
ErrCode |
String |
InternalError |
Código de erro retornado se a chamada falhar. |
|
ErrMessage |
String |
The request processing has failed due to some unknown error. |
Mensagem de erro retornada se a chamada falhar. |
|
HttpStatusCode |
String |
200 |
Código de status HTTP. |
|
RequestId |
String |
5F566C5B-E5B0-4020-A531-FC6F5005**** |
ID da solicitação. |
|
Success |
String |
true |
Indica se a chamada foi bem-sucedida. |
Exemplos
Exemplos de solicitações
http(s)://dts.aliyuncs.com/?Action=CreateConsumerChannel
&ConsumerGroupName=Consumer Group B
&ConsumerGroupPassword=Test123456
&ConsumerGroupUserName=dtstest
&RegionId=cn-hangzhou
&DtsInstanceId=dtsboss6pn1w******
Exemplos de respostas de sucesso
Formato XML
<CreateConsumerChannelResponse>
<ConsumerGroupID>dtsor2y66j4219****</ConsumerGroupID>
<RequestId>5F566C5B-E5B0-4020-A531-FC6F5005****</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Success>true</Success>
</CreateConsumerChannelResponse>
Formato JSON
{
"ConsumerGroupID": "dtsor2y66j4219****",
"RequestId": "5F566C5B-E5B0-4020-A531-FC6F5005****",
"HttpStatusCode": 200,
"Success": true
}
Códigos de erro
Para obter uma lista de códigos de erro, visite o Centro de Erros de API.