全部产品
Search
文档中心

日志服务:get_check_point

更新时间:Oct 26, 2023

调用CLI命令获取指定消费组的checkpoint。

请求语法

aliyunlog log get_check_point --project=<value> --logstore=<value> --consumer_group=<value> [--shard=<value>] [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]

请求参数

该命令的必选和特有参数描述如下。
参数名称数值类型是否必选示例值描述
--projectStringaliyun-test-projectProject名称。
--logstoreStringlogstore-aLogstore名称。
--consumer_groupStringconsumer-group-1消费组名称。
--shardInteger1Shard ID。
  • 如果指定的Shard不存在,则返回空列表。
  • 如果不指定Shard,则返回所有Shard的checkpoint。
关于该命令的全局参数,请参见全局参数

示例

  • 请求示例
    使用获取消费组的checkpoint。
    aliyunlog log get_check_point --project="aliyun-test-project" --logstore="logstore-a" --consumer_group="consumer-group-1" --shard_id=1
  • 返回示例
    [
      {
        "checkpoint": "MTUyNDE1NTM3OTM3MzkwODQ5Ng==",
        "consumer": "consumer-group-1",
        "shard": 1,
        "updateTime": 1622636965080584
      }
    ]

错误码

如果返回报错信息,请参见具体接口的错误码处理。更多信息,请参见GetCheckPoint错误码处理

API参考

GetCheckPoint