Modifies the information of a consumer group, including the consumer group name, username, and password.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer automatically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyConsumerChannel

The operation that you want to perform. Set the value to ModifyConsumerChannel.

ConsumerGroupId String Yes dtsor2y66j4219****

The ID of the consumer group. You can call the DescribeConsumerChannel operation to query the consumer group ID.

RegionId String Yes cn-hangzhou

The ID of the region where the change tracking instance resides. For more information, see List of supported regions.

DtsInstanceId String No dtsboss6pn1w73****

The ID of the change tracking instance. You can call the DescribeDtsJobs operation to query the instance ID.

Note You must specify at least one of the DtsInstanceId and DtsJobId. parameters.
DtsJobId String No boss6pn1w73****

The ID of the change tracking task. You can call the DescribeDtsJobs operation to query the task ID.

Note You must specify at least one of the DtsInstanceId and DtsJobId. parameters.
ConsumerGroupPassword String No Test123456

The new password of the consumer group.

  • A password must contain two or more of the following characters: uppercase letters, lowercase letters, digits, and special characters.
  • A password must be 8 to 32 characters in length.
ConsumerGroupUserName String No dtstest

The new username of the consumer group.

  • A username must contain one or more of the following characters: uppercase letters, lowercase letters, digits, and underscores (_).
  • A username cannot exceed 16 characters in length.
ConsumerGroupName String No Consumer Group B

The name of the consumer group. The name cannot exceed 128 characters in length. We recommend that you use an informative name for easy identification.

Response parameters

Parameter Type Example Description
ErrCode String InternalError

The error code returned if the call failed.

ErrMessage String The request processing has failed due to some unknown error.

The error message returned if the call failed.

HttpStatusCode String 200

The HTTP status code.

RequestId String 055CAF9B-C15D-4799-BB9E-E62D417****

The ID of the request.

Success String true

Indicates whether the call was successful.

Examples

Sample requests

http(s)://dts.aliyuncs.com/?Action=ModifyConsumerChannel
&ConsumerGroupId=dtsor2y66j4219****
&RegionId=cn-hangzhou
&DtsInstanceId=dtsboss6pn1w73****
&ConsumerGroupName=Consumer Group B

Sample success responses

XML format

<ModifyConsumerChannelResponse>
      <RequestId>055CAF9B-C15D-4799-BB9E-E62D417****</RequestId>
      <HttpStatusCode>200</HttpStatusCode>
      <Success>true</Success>
</ModifyConsumerChannelResponse>

JSON format

{
	"RequestId": "055CAF9B-C15D-4799-BB9E-E62D417****",
	"HttpStatusCode": 200,
	"Success": true
}

Error codes

For a list of error codes, visit the API Error Center.