Todos os produtos
Search

Este produto

    Simple Log Service:update_consumer_group

    Central de documentação

    Simple Log Service:update_consumer_group

    Última atualização: Sep 14, 2026

    Use o comando da interface de linha de comando (CLI) update_consumer_group para modifique informações de um consumer group específico.

    Sintaxe da solicitação

    aliyunlog log update_consumer_group --project=<value> --logstore=<value> --consumer_group=<value> [--timeout=<value>] [--in_order=<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 deste comando.

    Nome do parâmetro

    Tipo de dados

    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 consumer group.

    --timeout

    Integer

    Não

    360

    Tempo limite. Unidade: segundos.

    Os consumidores enviam heartbeats periódicos ao Log Service. Se nenhum heartbeat for recebido nesse período, o Log Service libera os recursos do consumidor.

    --in_order

    Boolean

    Não

    true

    Define se as mensagens devem ser consumidas em ordem dentro de um único shard.

    • true: As mensagens são consumidas em ordem dentro de um único shard. Após a divisão de um shard, os dados do shard original são consumidos primeiro. Em seguida, os dados dos dois novos shards são consumidos em paralelo.

    • false: As mensagens não são consumidas em ordem.

    Para obter informações sobre os parâmetros globais deste comando, consulte Global parameters.

    Exemplos

    • Exemplo de solicitação

      Modifique o tempo limite do consumer group consumer-group-1 usando a conta padrão.

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

    • Se o comando for executado com sucesso, nenhuma resposta será retornada. Execute o comando a seguir para consultar o consumer group.

      aliyunlog log list_consumer_group --project="aliyun-test-project" --logstore="logstore-a"

      O resultado a seguir é retornado:

      [
  {
    "name": "consumer-group-1",
    "order": true,
    "timeout": 360
  }
]

    Códigos de erro

    Caso uma mensagem de erro seja retornada, consulte a documentação de códigos de erro desta operação de API. Para mais informações, veja Error codes.

    Referência da API

    UpdateConsumerGroup