Todos os produtos
Search

Este produto

    Simple Log Service:update_logstore

    Central de documentação

    Simple Log Service:update_logstore

    Última atualização: Jul 03, 2026

    Atualiza a configuração de um Logstore, incluindo retenção de dados, camadas de armazenamento, sharding e configurações de rastreamento.

    Pré-requisitos

    Antes de executar este comando, certifique-se de ter:

    Sintaxe

    aliyunlog log update_logstore \
  --project_name=<value> \
  --logstore_name=<value> \
  [--ttl=<value>] \
  [--enable_tracking=<value>] \
  [--shard_count=<value>] \
  [--append_meta=<value>] \
  [--auto_split=<value>] \
  [--max_split_shard=<value>] \
  [--preserve_storage=<value>] \
  [--encrypt_conf=<value>] \
  [--hot_ttl=<value>] \
  [--mode=<value>] \
  [--telemetry_type=<value>] \
  [--infrequent_access_ttl=<value>]

    Para parâmetros globais como --access-id, --access-key, --region-endpoint e --format-output, consulte Parâmetros globais.

    Parâmetros

    Parâmetro

    Tipo

    Obrigatório

    Exemplo

    Descrição

    --project_name

    String

    Sim

    aliyun-test-project

    Nome do projeto. Projetos isolam recursos e controlam o acesso. Para mais informações, consulte Gerencie projetos.

    --logstore_name

    String

    Sim

    logstore-a

    Nome do Logstore. Imutável após a criação e exclusivo dentro do projeto. Regras de nomenclatura: letras minúsculas, dígitos, hifens (-) e sublinhados (_); deve começar com letra minúscula e terminar com letra minúscula ou dígito; 3 a 63 caracteres.

    --ttl

    Integer

    Não

    30

    Período total de retenção de dados em dias. Valores válidos: 1 a 3650. Defina como 3650 para armazenamento permanente. Ao expirar o período de retenção, o SLS exclui os dados vencidos. O valor de --ttl equivale à soma de --hot_ttl, --infrequent_access_ttl e o período de retenção do armazenamento Archive.

    --shard_count

    Integer

    Não

    2

    Número de shards. A CLI aceita este parâmetro, mas o ignora silenciosamente. Para ajustar a quantidade de shards, use SplitShard ou MergeShard. Para mais detalhes, consulte Intervalo de shards.

    --enable_tracking

    Boolean

    Não

    true

    Ativa (true) ou desativa (false) o WebTracking.

    --append_meta

    Boolean

    Não

    false

    Registra (true) ou omite (false) os endereços IP públicos dos clientes.

    --auto_split

    Boolean

    Não

    true

    Ativa (true) ou desativa (false) a divisão automática de shards.

    --max_split_shard

    Integer

    Não

    64

    Quantidade máxima de shards que a divisão automática pode criar. Valores válidos: 1 a 256. Obrigatório quando --auto_split for true.

    --encrypt_conf

    String

    Não

    --

    Configuração de criptografia em formato JSON. Para a estrutura de dados, consulte EncryptConf.

    --telemetry_type

    String

    Não

    None

    Tipo de dado observável armazenado no Logstore. None (padrão): logs. Metrics: dados de séries temporais.

    --hot_ttl

    Integer

    Não

    7

    Período de retenção da camada de armazenamento quente (hot), em dias. Mínimo: 7. Máximo: valor de --ttl. Defina como -1 para manter todos os dados no armazenamento quente. Após esse período, os dados migram para a camada Infrequent Access (IA). Regras de transição entre camadas: de quente para IA exige pelo menos 7 dias em quente; de IA para Archive exige pelo menos 30 dias em IA; de quente para Archive (ignorando IA) exige pelo menos 30 dias em quente. Para mais informações, consulte Configure armazenamento inteligente em camadas.

    --mode

    String

    Não

    standard

    Tipo do Logstore. standard (padrão): Logstore Padrão. Suporta análise de logs, monitoramento em tempo real e análise interativa. Ideal para construir um sistema abrangente de observabilidade. query (valor na CLI: lite): Logstore de Consulta. Otimizado para consultas de alto desempenho com custo de tráfego de índice reduzido pela metade. Não suporta instruções SELECT. Recomendado para grandes conjuntos de dados com longos períodos de retenção ou quando a análise de logs não é necessária. Para mais detalhes, consulte Gerencie um Logstore.

    --infrequent_access_ttl

    Integer

    Não

    30

    Período de retenção da camada IA, em dias. Os dados devem permanecer na camada IA por pelo menos 30 dias antes de migrarem para a camada de armazenamento Archive. Para mais informações, consulte Configure armazenamento inteligente em camadas.
    Importante

    Ao reduzir o valor de --ttl, o SLS exclui todos os dados recém-vencidos em até 1 hora. Por exemplo, alterar a retenção de 5 dias para 1 dia faz com que o SLS exclua os dados de log dos 4 dias anteriores dentro de 1 hora. O uso de armazenamento exibido na página Usage Details do console SLS será atualizado no dia seguinte.

    Importante

    Não é possível modificar a contagem de shards via update_logstore. A CLI aceita o parâmetro --shard_count sem erros, mas ignora o valor silenciosamente. Para ajustar o número de shards, use SplitShard ou MergeShard.

    Exemplos

    Defina o período de retenção de dados para 30 dias e ative o WebTracking para o Logstore logstore-a no projeto aliyun-test-project:

    aliyunlog log update_logstore \
  --project_name="aliyun-test-project" \
  --logstore_name="logstore-a" \
  --ttl=30 \
  --enable_tracking=true

    Um comando bem-sucedido não gera saída. Execute o comando abaixo para verificar a atualização:

    aliyunlog log get_logstore \
  --project_name="aliyun-test-project" \
  --logstore_name="logstore-a" \
  --format-output=json

    Verifique se os campos ttl e enable_tracking na saída JSON correspondem aos valores definidos.

    Referências