CreateConsumerGroup - Data Transmission Service - Centro de documentación de Alibaba Cloud

Crea un grupo de consumidores para una instancia de seguimiento de cambios.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. Esta herramienta también genera automáticamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateConsumerGroup	La operación que desea ejecutar. Establezca el valor en CreateConsumerGroup.
ConsumerGroupName	String	Sí	Test Consumer Group	Nombre del grupo de consumidores. No debe exceder los 128 caracteres. Se recomienda usar un nombre descriptivo para facilitar su identificación.
ConsumerGroupPassword	String	Sí	Test123456	Contraseña correspondiente al nombre de usuario del grupo de consumidores. Debe contener al menos dos de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Debe tener entre 8 y 32 caracteres.
ConsumerGroupUserName	String	Sí	dtstest	Nombre de usuario del grupo de consumidores. Debe contener al menos uno de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y guiones bajos (_). No debe exceder los 16 caracteres.
SubscriptionInstanceId	String	Sí	dtsg2m10r1x15a****	ID de la instancia de seguimiento de cambios. Puede llamar a la operación DescribeSubscriptionInstances para consultar el ID de la instancia.
RegionId	String	No	cn-hangzhou	ID de la región donde reside la instancia de seguimiento de cambios. Para obtener más información, consulte la Lista de regiones compatibles.
AccountId	String	No	12323344****	ID de la cuenta de Alibaba Cloud. No es necesario especificar este parámetro porque se eliminará en el futuro.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
ConsumerGroupID	String	dtswc411cg617p****	ID del grupo de consumidores.
ErrCode	String	InternalError	Código de error devuelto si la llamada falla.
ErrMessage	String	The request processing has failed due to some unknown error.	Mensaje de error devuelto si la llamada falla.
RequestId	String	6063641E-BAD1-4BA7-B70B-26FFFD18****	ID de la solicitud.
Success	String	true	Indica si la llamada fue exitosa.

Ejemplos

Solicitudes de ejemplo

http(s)://dts.aliyuncs.com/?Action=CreateConsumerGroup
&ConsumerGroupName=Test Consumer Group
&ConsumerGroupPassword=Test123456
&ConsumerGroupUserName=dtstest
&SubscriptionInstanceId=dtsg2m10r1x15a****
&<Common request parameters>

Respuestas de ejemplo

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 error

Para obtener una lista de códigos de error, visite el Centro de errores de API.