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.
| Action | Resource |
log:CreateLogStore | acs:log:{#regionId}:{#accountId}:project/{#project}/logstore/{#logstoreName} |
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
log:CreateLogStore |
create |
*LogStore
|
|
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:
|
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 Exemplo 1 (Ativar criptografia padrão):
Exemplo 2 (Ativar criptografia BYOK): |
|
| 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 |
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 |
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.
|
false |
| telemetryType |
string |
Não |
O tipo de dados observáveis. Valor padrão: dados de log. Valores válidos:
|
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 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:
|
60 |
| mode |
string |
Não |
O Log Service fornece dois tipos de Logstores: standard e query.
|
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 ( Exemplos:
|
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.