Todos os produtos
Search
Central de documentação

Simple Log Service:update_check_point

Última atualização: Jul 03, 2026

Modifica o checkpoint de um shard consumido por um grupo de consumidores.

Sintaxe da solicitação

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>]

Parâmetros da solicitação

A tabela a seguir descreve os parâmetros obrigatórios e específicos do comando update_check_point.

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

--project

String

Sim

aliyun-test-project

Nome do projeto.

--logstore

String

Sim

logstore-a

Nome do Logstore.

--consumer_group

String

Sim

consumer-group-1

Nome do grupo de consumidores.

--shard

Integer

Sim

1

ID do shard.

--check_point

String

Sim

MTUyNDE1NTM3OTM3MzkwODQ5Ng==

Valor do checkpoint.

--consumer

String

Não

consumer_1

Consumidor.

--force_success

Boolean

Não

true

Especifica se as atualizações forçadas devem ser ativadas.

  • True: ativa atualizações forçadas.

  • False: desativa atualizações forçadas.

Para obter informações sobre os parâmetros globais da interface de linha de comando (CLI) do Simple Log Service, consulte Parâmetros globais.

Exemplos

  • Modifique o checkpoint de um shard consumido por um grupo de consumidores específico. Exemplo de solicitação:

    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

    O comando não retorna resposta após a execução.

  • Modifique o tempo limite do grupo de consumidores consumer-group-1 com a conta padrão. Exemplo de solicitação:

    aliyunlog log update_consumer_group --project="aliyun-test-project" --logstore="logstore-a" --consumer_group="consumer-group-1" --timeout="360" --in_order=true

    O comando não retorna resposta após a execução. Execute o seguinte comando para consultar grupos de consumidores:

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

    Resposta:

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

Códigos de erro

Se houver uma mensagem de erro, corrija-o com base nos códigos de erro da operação de API correspondente. Para mais informações, consulte Códigos de erro de UpdateCheckPoint.

Referência da API

UpdateCheckPoint