Todos os produtos
Search
Central de documentação

Data Transmission Service:CreateConsumerChannel

Última atualização: Jun 27, 2026

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

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera códigos de exemplo da operação para diferentes SDKs.

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.

  • Deve conter pelo menos dois dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais.
  • Deve ter de 8 a 32 caracteres.
ConsumerGroupUserName String Sim dtstest

Nome de usuário do grupo de consumidores.

  • Deve incluir pelo menos um dos seguintes caracteres: letras maiúsculas, letras minúsculas, dígitos e sublinhados (_).
  • Limite de 16 caracteres.
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.