Todos os produtos
Search
Central de documentação

Simple Log Service:update_consumer_group

Última atualização: Jul 03, 2026

Modifique as informações de um consumer group especificado.

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 do comando update_consumer_group.

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 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 o consumo de dados ocorre em sequência a partir de um shard. Valores válidos:

  • true: consome os dados de um shard em sequência. Se houver divisão do shard, o sistema consome primeiro os dados do shard original e, em seguida, consome simultaneamente os dados dos novos shards.

  • false: consome os dados de um shard aleatoriamente.

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

Exemplos

  • Exemplos de solicitações

    Use a conta padrão para modifique o tempo limite de um consumer group chamado 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
  • Exemplos de respostas

    O comando não retorna resposta após a execução. Execute o seguinte comando para consultar consumer groups.

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

    Respostas:

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

Códigos de erro

Se uma mensagem de erro for retornada, corrija o problema com base nos códigos de erro da operação de API relacionada. Para mais informações, consulte Códigos de erro.

Referência da API

UpdateConsumerGroup