Todos os produtos
Search
Central de documentação

Simple Log Service:CreateLogStore

Última atualização: Jun 28, 2026

Cria um Logstore.

Descrição da operação

Notas de uso

  • O cabeçalho Host da solicitação consiste em um nome de projeto e um endpoint do Log Service. Você deve especificar o projeto neste cabeçalho.

  • Você deve criar e obter uma AccessKey. Para mais informações, consulte AccessKey.

O par de AccessKey de uma conta Alibaba Cloud possui permissões completas para todas as operações de API, o que representa um risco de segurança. Para maior segurança, recomendamos fortemente o uso de um usuário RAM para chamar operações de API ou realizar O&M de rotina. Você deve conceder ao usuário RAM permissões para gerenciar recursos do Log Service. Para mais informações, consulte Criar e autorizar um usuário RAM.

  • Certifique-se de ter o nome e a região do projeto onde deseja criar o Logstore. Para mais informações, consulte Gerenciar projetos.

  • Você pode criar no máximo 200 Logstores em um projeto.

  • O Log Service exclui automaticamente os logs após o período de retenção de dados especificado expirar.

Autorização

A tabela a seguir lista a permissão necessária para chamar esta API. Para conceder essa permissão a um usuário RAM ou função RAM, adicione a Action correspondente a uma declaração de política RAM.

ActionResource
log:CreateLogStoreacs:log:{#regionId}:{#accountId}:project/{#project}/logstore/{#logstoreName}

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

log:CreateLogStore

create

*LogStore

acs:log:{#regionId}:{#accountId}:project/{#project}/logstore/{#logstoreName}

  • log:TLSVersion
  • log:Encrypted
Nenhuma

Sintaxe da solicitação

POST /logstores HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

project

string

Sim

O nome do projeto.

ali-test-project

body

object

Sim

Os parâmetros do corpo da solicitação.

logstoreName

string

Sim

O nome do Logstore. O nome deve atender aos seguintes requisitos:

  • O nome deve ser exclusivo dentro de um projeto.

  • O nome pode conter apenas letras minúsculas, dígitos, hifens (-) e underscores (_).

  • O nome deve começar e terminar com uma letra minúscula ou um dígito.

  • O nome deve ter de 2 a 63 caracteres.

my-logstore

shardCount

integer

Sim

O número de shards.

Nota

Você não pode atualizar a contagem de shards com esta operação. Para isso, chame a operação SplitShard ou MergeShards.

2

ttl

integer

Sim

O período de retenção de dados em dias. Valores válidos: 1 a 3.650. Se você definir este parâmetro como 3.650, os dados serão armazenados permanentemente.

1

encrypt_conf EncryptConf

Não

A configuração de criptografia. Esta estrutura de dados inclui os parâmetros enable, encrypt_type e user_cmk_info. Para mais informações, consulte EncryptConf.

Exemplo 1 (Ativar criptografia padrão):

{
    "enable": true,
    "encrypt_conf": "default"
}

Exemplo 2 (Ativar criptografia BYOK):

{
    "enable": true,
    "encrypt_conf": "default",
    "user_cmk_info": {
        "cmk_key_id": "xxxxx",
        "arn": "acs:ram::112340000000:role/rolename",
        "region": "cn-hangzhou"
    }
}

autoSplit

boolean

Não

Especifica se a divisão automática de shards deve ser ativada. Se você definir este parâmetro como true, o Log Service divide automaticamente um shard para aumentar a taxa de transferência de gravação quando o tráfego de gravação no shard excede continuamente o limite do serviço. Se você ativar a divisão automática de shards, também deverá especificar maxSplitShard.

true

enable_tracking

boolean

Não

Especifica se o WebTracking deve ser ativado. O valor padrão é false. Este recurso permite coletar e analisar dados de comportamento do usuário de navegadores ou mini programas, como visualizações de página, histórico de compras e tempo de permanência.

false

maxSplitShard

integer

Não

O número máximo de shards após uma divisão automática. O valor deve ser um inteiro de 1 a 256.

Nota

Este parâmetro é obrigatório se você definir autoSplit como true.

64

appendMeta

boolean

Não

Especifica se o endereço IP público de origem e o horário de recebimento do servidor devem ser registrados. Valor padrão: false.

  • true: O Log Service anexa automaticamente o endereço IP público do dispositivo de origem e o horário de recebimento do servidor ao campo Tag dos logs.

  • false: O Log Service não anexa o endereço IP público de origem nem o horário de recebimento do servidor.

false

telemetryType

string

Não

O tipo de dados observáveis. Valor padrão: dados de log. Valores válidos:

  • None: dados de log. Este é o valor padrão.

  • Metrics: dados de Metrics.

None

hot_ttl

integer

Não

O período de retenção de dados na camada de armazenamento hot do Logstore, em dias. O valor deve ser um inteiro de 7 até o valor de ttl. Se você não especificar este parâmetro, os dados serão armazenados na camada de armazenamento hot durante todo o período de retenção de dados especificado por ttl.

Após o período de retenção do armazenamento hot expirar, os dados são movidos para a camada de armazenamento de Acesso Infrequente (IA). Para ativar o armazenamento IA, você deve definir o período de retenção do armazenamento hot para pelo menos 7 dias. Para mais informações, consulte Smart Tiered Storage.

Exemplos:

  • Cenário 1 (Armazenar dados na camada de armazenamento hot por 30 dias): {"ttl": 30} ou {"ttl": 30, "hot_ttl": 30}

  • Cenário 2 (Armazenar dados na camada de armazenamento hot por 7 dias e na camada de armazenamento IA por 23 dias): {"ttl": 30, "hot_ttl": 7}

60

mode

string

Não

O Log Service fornece dois tipos de Logstores: standard e query.

  • standard: Suporta análise de dados de ponta a ponta. Este modo é adequado para cenários como monitoramento em tempo real, análise interativa e construção de um sistema completo de observabilidade.

  • query: Suporta consultas de alto desempenho. O custo de tráfego de índice é aproximadamente metade do modo standard, mas a análise SQL não é suportada. Este modo é adequado para cenários que envolvem grandes volumes de dados, longos períodos de retenção como semanas ou meses, e não requerem análise baseada em SQL.

standard

infrequentAccessTTL

integer

Não

O período de retenção para armazenamento de Acesso Infrequente (IA), em dias. Embora este parâmetro não tenha valor mínimo, os dados devem permanecer na camada de armazenamento IA por pelo menos 30 dias antes de poderem ser movidos para o armazenamento de arquivo.

Se o período total de retenção (ttl) for maior que a soma do período de armazenamento hot (hot_ttl) e do período de armazenamento IA (infrequentAccessTTL), o tempo restante será o período de armazenamento de arquivo.

Exemplos:

  • Cenário 1 (Armazenar dados na camada de armazenamento hot por 7 dias e na camada de armazenamento IA por 23 dias): {"ttl": 30, "hot_ttl": 7}

  • Cenário 2 (Armazenar dados na camada de armazenamento hot por 7 dias, na camada de armazenamento IA por 30 dias e na camada de armazenamento de arquivo por 60 dias): {"ttl": 97, "hot_ttl": 7, "infrequentAccessTTL": 30}

  • Cenário 3 (Armazenar dados na camada de armazenamento hot por 60 dias e na camada de armazenamento de arquivo por 60 dias, com o período de armazenamento IA sendo 0 dias): {"ttl": 120, "hot_ttl": 60, "infrequentAccessTTL": 0}

30

processorId

string

Não

O ID do IngestProcessor.

processor-nginx-parser-001

shardingPolicy ShardingPolicy

Não

A configuração para gravações baseadas em hash. Ao gravar dados, os logs são armazenados em um shard selecionado com base na política de sharding baseada em hash configurada. Antes de configurar este parâmetro, certifique-se de que os intervalos de hash dos shards estejam distribuídos uniformemente. Uma configuração inadequada pode afetar o desempenho de gravação. Configure este parâmetro com cautela.

resourceGroupId

string

Não

O ID do grupo de recursos ao qual o Logstore pertence.

rg-xxxxxxxx

enableModify

boolean

Não

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

Nenhum definido.

Exemplos

Resposta de sucesso

JSON formato

{}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.