Cria um Logstore.
Descrição da operação
Descrição da operação
-
O Host na sintaxe da solicitação consiste no nome do projeto e no endpoint do Simple Log Service. Você deve especificar o projeto no Host.
-
Um par de AccessKey foi criado e obtido. Para mais informações, consulte Pares de AccessKey.
O par de AccessKey de uma conta Alibaba Cloud tem permissões de acesso a todas as operações de API. Usar o par de AccessKey de uma conta Alibaba Cloud para realizar operações é altamente arriscado. Crie e use um usuário RAM para chamar operações de API ou realizar O&M de rotina. O usuário RAM deve ter permissões para gerenciar recursos do Simple Log Service. Para mais informações, consulte Criar um usuário RAM e conceder permissões ao usuário RAM.
-
Você identificou o nome e a região do projeto ao qual os logs que deseja consultar pertencem. Para mais informações, consulte Gerenciar um projeto.
-
Você pode criar até 200 Logstores em um projeto.
-
Os logs são excluídos quando o período de retenção de dados expira.
Recursos de autenticação
A tabela a seguir lista as informações de autorização da operação de API. Você pode adicionar as informações ao elemento Action de uma instrução de política RAM para conceder a um usuário RAM ou função RAM as permissões para chamar esta operação de API.
| Action | Recurso |
log:CreateLogStore | acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/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 da solicitação. |
|
| logstoreName |
string |
Sim |
O nome do Logstore. O nome deve atender às seguintes regras:
|
my-logstore |
| shardCount |
integer |
Sim |
O número de shards. Nota
Você não pode usar esta operação de API para atualizar o número de shards. Você pode alterar o número de shards apenas chamando a operação SplitShard ou MergeShards. |
2 |
| ttl |
integer |
Sim |
O período de retenção de dados. Unidade: dias. Valores válidos: 1 a 3650. O valor 3650 indica retenção permanente. |
1 |
| encrypt_conf | EncryptConf |
Não |
A estrutura de configuração de criptografia, que inclui os parâmetros enable, encrypt_type e user_cmk_info. Para mais informações, consulte EncryptConf. Exemplo 1 (Ativar a configuração de criptografia padrão):
Exemplo 2 (Ativar a criptografia BYOK): |
|
| autoSplit |
boolean |
Não |
Especifica se o sharding automático deve ser ativado. Após a ativação desse recurso, se o tráfego de gravação de logs exceder continuamente o limite, os shards serão divididos automaticamente para melhorar a capacidade de gravação. Ao ativar o sharding automático, você deve configurar o parâmetro maxSplitShard para especificar o número máximo de shards. |
true |
| enable_tracking |
boolean |
Não |
Especifica se o recurso WebTracking deve ser ativado. Valor padrão: false. Você pode usar o recurso WebTracking para coletar e analisar dados de comportamento do usuário em navegadores ou miniprogramas, como visualizações de página, registros de compras e tempo no site. |
false |
| maxSplitShard |
integer |
Não |
O número máximo de shards que podem ser divididos automaticamente. Valor mínimo: 1. Valor máximo: 256. Nota
Este parâmetro é obrigatório quando o parâmetro autoSplit é definido como true. |
64 |
| appendMeta |
boolean |
Não |
Especifica se o endereço IP público e a hora de recebimento do log devem ser registrados. Valor padrão: false.
|
false |
| telemetryType |
string |
Não |
O tipo de dados observáveis. Valor padrão: log data. Valores válidos:
|
None |
| hot_ttl |
integer |
Não |
A duração de armazenamento dos dados na camada quente do Logstore. Unidade: dias. Valor mínimo: 7. O valor máximo não pode exceder o valor do parâmetro ttl. Por padrão, todos os dados são armazenados na camada quente dentro do período ttl. Quando a duração de armazenamento dos dados excede o período de retenção de dados especificado na camada quente, os dados são transferidos para a camada de acesso infrequente (IA). Ao ativar a camada IA, a duração de armazenamento quente deve ser de pelo menos 7 dias. Para mais informações, consulte Camadas inteligentes. Exemplos:
|
60 |
| mode |
string |
Não |
O Simple Log Service fornece dois tipos de Logstores: Standard e Query.
|
standard |
| infrequentAccessTTL |
integer |
Não |
A duração de armazenamento na camada IA. Nenhuma duração mínima de armazenamento é necessária. Os dados são transferidos para a camada de arquivamento após serem armazenados na camada IA por pelo menos 30 dias. Quando a duração de armazenamento do log excede a soma da duração de armazenamento quente e da duração de armazenamento IA, a duração de armazenamento restante é convertida para armazenamento de arquivamento. Exemplos:
|
30 |
| processorId |
string |
Não |
O ID do IngestProcessor. |
processor-nginx-parser-001 |
| shardingPolicy | ShardingPolicy |
Não |
A configuração de gravação baseada em hash. Quando os dados são gravados, os logs são armazenados em shards com base na política de hash configurada. Antes da configuração, certifique-se de que os intervalos de hash dos shards sejam uniformes. Esta configuração pode afetar a capacidade de gravação. Prossiga com cautela. |
|
| resourceGroupId |
string |
Não |
O ID do grupo de recursos. Após especificar este parâmetro, o Logstore é associado ao grupo de recursos. |
rg-xxxxxxxx |
| enableModify |
boolean |
Não |
Especifica se o recurso de modificação e exclusão de logs deve ser ativado. |
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.