全部產品
Search
文件中心

Simple Log Service:update_check_point

更新時間:Jun 30, 2024

調用CLI命令修改消費組消費資料時Shard的checkpoint。

請求文法

aliyunlog log update_check_point --project=<value> --logstore=<value> --consumer_group=<value> --shard=<value> --check_point=<value> [--consumer=<value>] [--force_success=<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>]

請求參數

該命令的必選和特有參數描述如下。

參數名稱

數實值型別

是否必選

樣本值

描述

--project

String

aliyun-test-project

Project名稱。

--logstore

String

logstore-a

Logstore名稱。

--consumer_group

String

consumer-group-1

消費組名稱。

--shard

Integer

1

Shard ID。

--check_point

String

MTUyNDE1NTM3OTM3MzkwODQ5Ng==

checkpoint值。

--consumer

String

consumer_1

消費者。

--force_success

Boolean

true

是否強制更新。

  • true:強制更新。

  • false:不強制更新。

關於該命令的全域參數,請參見全域參數

樣本

  • 請求樣本

    修改指定消費組消費資料時Shard的checkpoint。

    aliyunlog log update_check_point --project="aliyun-test-project" --logstore="logstore-a" --consumer_group="consumer-group-1" --shard=1 --check_point="MTUyNDE1NTM3OTM3MzkwODQ5Ng==" --consumer="consumer_1" --force_success=true
  • 命令執行成功後,無響應訊息。

    樣本

    • 請求樣本

      使用預設帳號修改消費組consumer-group-1的逾時時間。

      aliyunlog log update_consumer_group --project="aliyun-test-project" --logstore="logstore-a" --consumer_group="consumer-group-1" --timeout="360" --in_order=true
    • 命令執行成功後,無響應訊息。您可以執行如下命令查詢消費組。

      aliyunlog log  get_check_point --project="aliyun-test-project" --logstore="logstore-a" --shard=3

      返回結果如下:

      [
        {
          "checkpoint": "MTUyNDE1NTM3OTM3MzkwODQ5Ng==",
          "consumer": "",
          "shard": 3,
          "updateTime": 1719544024896258
        }
      ]

錯誤碼

如果返回報錯資訊,請參見具體介面的錯誤碼處理。更多資訊,請參見UpdateCheckPoint錯誤碼處理

API參考

UpdateCheckPoint