文档中心

数据库传输服务

请输入

数据订阅（消费组管理）

DescribeSubscriptionGroupProgress

调用 DescribeSubscriptionGroupProgress 接口查询订阅消费组进度。

请求类型

同步请求。

请求参数

参数	类型	是否必选	示例值	描述
TaskId	String	是	4ddec6d036384248a25862fb********	任务 ID。说明您可以调用 DescribeTransmissionTasks接口查询任务 ID。
GroupName	String	是	9863318d02ed4a6f88f14c03a28c5b6c:test****	消费组名称。说明您可以调用 DescribeSubscriptionGroups接口查看消费组的名称。

返回参数

参数	类型	示例值	描述
DelayTime	Long	0	延迟时间。
Partitions	Array of SubscriptionPartitionProgress	[ { "Id": 0, "Offset": -1, "LogEndOffset": 0 } ]	分片的进度信息。

SubscriptionPartitionProgress

参数	类型	示例值	描述
Id	Integer	0	分区 ID。
LogEndOffset	Long	0	最高位点数。
Offset	Long	-1	当前消费位点。

示例

请求示例

POST /?Action=DescribeSubscriptionGroupProgress&Version=2022-10-01 HTTP/1.1​
Content-Type: application/json​
Host: dts.cn-beijing.volcengineapi.com​
X-Date: 20221001T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20221001/cn-beijing/dts/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****​
{​
    "TaskId": "9863318d02ed4a6f88f14c03a2*****",​
    "GroupName": "9863318d02ed4a6f88f14c03a28c5b6c:test****"​
}​

返回示例

{​
    "ResponseMetadata": {​
        "Action": "DescribeSubscriptionGroupProgress",​
        "Region": "cn-beijing",​
        "Service": "dts",​
        "Version": "2022-10-01",​
        "RequestId": "20230604110420****100232280022D31"​
    },​
    "Result": {​
        "DelayTime": 0,​
        "Partitions": [​
            {​
                "Id": 0,​
                "Offset": -1,​
                "LogEndOffset": 0​
            }​
        ]​
    }​
}​

错误码

更多详情，请参见错误码。

最近更新时间：2026.02.03 14:24:30

这个页面对您有帮助吗？

有用

无用