Todos os produtos
Search

Este produto

    Simple Log Service:create_logstore

    Central de documentação

    Simple Log Service:create_logstore

    Última atualização: Jul 03, 2026

    Cria um Logstore em um projeto específico.

    Pré-requisitos

    Verifique se:

    Sintaxe do comando

    aliyunlog log create_logstore \
  --project_name=<value> \
  --logstore_name=<value> \
  [--ttl=<value>] \
  [--shard_count=<value>] \
  [--enable_tracking=<value>] \
  [--append_meta=<value>] \
  [--auto_split=<value>] \
  [--max_split_shard=<value>] \
  [--preserve_storage=<value>] \
  [--encrypt_conf=<value>] \
  [--telemetry_type=<value>] \
  [--hot_ttl=<value>] \
  [--mode=<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>] \
  [--profile=<value>]

    Exemplos

    Criar um Logstore com configurações padrão

    Crie um Logstore chamado logstore-a no projeto aliyun-test-project:

    aliyunlog log create_logstore \
  --project_name="aliyun-test-project" \
  --logstore_name="logstore-a"

    O comando não gera saída em caso de sucesso. Para verificar, execute:

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

    Criar um Logstore com uma conta nomeada

    Crie um Logstore chamado logstore-b usando a conta test:

    aliyunlog log create_logstore \
  --project_name="aliyun-test-project" \
  --logstore_name="logstore-b" \
  --client-name="test"

    Verifique o resultado:

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

    Resposta de exemplo:

    {
  "appendMeta": false,
  "archiveSeconds": 0,
  "autoSplit": true,
  "createTime": 1719280391,
  "enable_tracking": false,
  "lastModifyTime": 1719282255,
  "logstoreName": "logstore-b",
  "maxSplitShard": 64,
  "mode": "standard",
  "productType": "",
  "resourceQuota": {
    "storage": {
      "preserved": -1,
      "used": 0
    }
  },
  "shardCount": 5,
  "telemetryType": "",
  "ttl": 30
}

    Parâmetros

    Esta seção lista apenas os parâmetros específicos do comando. Para detalhes sobre parâmetros globais (--access-id, --access-key, --sts-token, --region-endpoint, --client-name, --jmes-filter, --format-output, --decode-output, --profile), consulte Parâmetros globais.

    Parâmetros obrigatórios

    Parâmetro

    Tipo

    Descrição

    Exemplo

    --project_name

    String

    Nome do projeto. Consulte Gerenciar um projeto.

    aliyun-test-project

    --logstore_name

    String

    Nome do Logstore. Imutável após a criação. Consulte Regras de nomenclatura.

    logstore-a

    Parâmetros opcionais

    Parâmetro Tipo Padrão Descrição Exemplo
    --ttl Integer 30 Período de retenção de dados em dias (1–3650). Defina como 3650 para armazenamento permanente. O sistema exclui dados expirados automaticamente. A retenção total corresponde à soma dos períodos de armazenamento quente, IA e Archive. 30
    --shard_count Integer -- Quantidade de shards (1–10). Consulte Intervalo de valores MD5. 2
    --enable_tracking Boolean false Ativa o rastreamento web. true
    --append_meta Boolean false Registra endereços IP públicos. false
    --auto_split Boolean true Ativa a divisão automática de shards. true
    --max_split_shard Integer 64 Limite máximo de shards na divisão automática. Valores válidos: 1 a 256. Obrigatório se --auto_split for true. 64
    --preserve_storage Boolean false Ativa o armazenamento permanente. Se definido como true, o sistema ignora --ttl e armazena os dados permanentemente. true
    --encrypt_conf String None Configuração de criptografia. Estrutura de dados: EncryptConf. None
    --telemetry_type String None Tipo de dado de observabilidade. Valores válidos: None (logs) e Metrics (métricas).
    Importante

    Imutável após a criação.

    		 None
    --hot_ttl Integer -- Retenção no armazenamento quente, em dias. Mínimo: 7. Máximo: não pode exceder --ttl. Defina como -1 para manter todos os dados no armazenamento quente. Após esse período, os dados migram para o armazenamento IA. Consulte Regras de camadas de armazenamento. 60
    --mode String standard Tipo de Logstore. Valores válidos: standard (Logstore padrão) e query (Logstore de consulta).
    Importante

    Imutável após a criação. Consulte Escolher um tipo de Logstore.

    		 standard

    Regras de nomenclatura

    Requisitos para --logstore_name:

    • Ter entre 3 e 63 caracteres.

    • Conter apenas letras minúsculas, dígitos, hifens (-) e sublinhados (_).

    • Começar com uma letra minúscula.

    • Terminar com uma letra minúscula ou dígito.

    • Ser globalmente único.

    • Ser imutável após a criação.

    Escolher um tipo de Logstore

    O parâmetro --mode define o tipo de Logstore:

    Recurso

    **Logstore padrão (standard)**

    **Logstore de consulta (query)**

    Análise de logs (instruções SELECT)

    Compatível

    Incompatível

    Painel

    Compatível

    Incompatível

    Custo de tráfego de índice

    Tarifa padrão

    Aproximadamente metade da tarifa padrão

    Mais indicado para

    Monitoramento em tempo real, análise interativa e observabilidade completa

    Ingestão de grande volume com longa retenção e cargas de trabalho apenas de busca

    Consulte também: Comparação de Logstores por tipo.

    Regras de camadas de armazenamento

    O parâmetro --hot_ttl determina a duração da permanência dos dados no armazenamento quente antes da transição para camadas de menor custo. Retenção mínima por camada:

    Transição

    Retenção mínima

    Armazenamento quente para Infrequent Access (IA)

    7 dias no armazenamento quente

    Armazenamento IA para Archive

    30 dias no armazenamento IA

    Armazenamento quente para Archive (direto)

    30 dias no armazenamento quente

    Para mais detalhes sobre as políticas de transição, consulte Configurar armazenamento inteligente em camadas.

    Referências