Todos os produtos
Search
Central de documentação

Data Transmission Service:CreateConsumerGroup

Última atualização: Jun 27, 2026

Cria um grupo de consumidores para uma instância de rastreamento de alterações.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer também gera automaticamente exemplos de código da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim CreateConsumerGroup

Operação a ser executada. Defina o valor como CreateConsumerGroup.

ConsumerGroupName String Sim Test Consumer Group

Nome do grupo de consumidores. O limite é de 128 caracteres. Use um nome descritivo para facilitar a identificação.

ConsumerGroupPassword String Sim Test123456

Senha correspondente ao nome de usuário do grupo de consumidores.

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

Nome de usuário do grupo de consumidores.

  • O nome de usuário deve conter pelo menos um dos seguintes caracteres: letras maiúsculas, letras minúsculas, dígitos e sublinhados (_).
  • O nome de usuário não pode exceder 16 caracteres.
SubscriptionInstanceId String Sim dtsg2m10r1x15a****

ID da instância de rastreamento de alterações. Chame a operação DescribeSubscriptionInstances para consultar o ID da instância.

RegionId String Não cn-hangzhou

ID da região onde a instância de rastreamento de alterações está localizada. Para mais informações, consulte Lista de regiões suportadas.

AccountId String Não 12323344****

ID da conta Alibaba Cloud. Não é necessário especificar este parâmetro, pois ele será removido futuramente.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

ConsumerGroupID

String

dtswc411cg617p****

ID do grupo de consumidores.

ErrCode

String

InternalError

Código de erro retornado quando a chamada falha.

ErrMessage

String

The request processing has failed due to some unknown error.

Mensagem de erro retornada quando a chamada falha.

RequestId

String

6063641E-BAD1-4BA7-B70B-26FFFD18****

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=CreateConsumerGroup
&ConsumerGroupName=Test Consumer Group
&ConsumerGroupPassword=Test123456
&ConsumerGroupUserName=dtstest
&SubscriptionInstanceId=dtsg2m10r1x15a****
&<Common request parameters>

Exemplos de respostas

Formato XML

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

Formato JSON

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

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.