Todos os produtos
Search
Central de documentação

Simple Log Service:get_check_point

Última atualização: Jul 03, 2026

Consulta o checkpoint de um shard consumido por um grupo de consumidores específico.

Sintaxe da solicitação

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

Parâmetros da solicitação

A tabela a seguir descreve os parâmetros do comando get_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

Não

1

ID do shard.

  • Se o shard especificado não existir, o sistema retornará uma lista vazia.

  • Sem a especificação de um ID de shard, a resposta incluirá os checkpoints de todos os shards.

Para obter informações sobre os parâmetros globais da CLI do Log Service, consulte Parâmetros globais.

Exemplos

  • Exemplos de solicitações

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

    aliyunlog log get_check_point --project="aliyun-test-project" --logstore="logstore-a" --consumer_group="consumer-group-1" --shard=1
  • Exemplos de respostas

    [
      {
        "checkpoint": "MTUyNDE1NTM3OTM3MzkwODQ5Ng==",
        "consumer": "consumer-group-1",
        "shard": 1,
        "updateTime": 1622636965080584
      }
    ]

Códigos de erro

Em caso de mensagem de erro, corrija o problema com base nos códigos de erro da operação de API correspondente. Para mais informações, consulte Códigos de erro.

Referência da API

GetCheckPoint