Atualiza os atributos de um Logstore.
Descrição da operação
Descrição da operação
Antes de atualizar um Logstore, chame a operação GetLogStore para obter a configuração atual do Logstore. Modifique a configuração conforme necessário e passe-a como parâmetros para a operação UpdateLogStore.
O Host na sintaxe da solicitação consiste no nome do projeto e no endpoint do Simple Log Service. Especifique o projeto no Host.
Um par de AccessKey foi criado e obtido. Para mais informações, consulte Par de AccessKey.
Um par de AccessKey de conta Alibaba Cloud tem permissões de acesso em todas as operações de API. Isso representa um alto risco de segurança. Recomendamos que você crie e use um usuário do Resource Access Management (RAM) para chamar operações de API ou executar O&M rotineiro. O usuário RAM deve ter as permissões necessárias nos recursos EPS do Simple Log Service. Para mais informações, consulte Criar um usuário RAM e autorização.
Você determinou o nome do projeto, a região e o nome do Logstore para os logs que deseja consultar. Para mais informações, consulte Gerenciar um projeto e Gerenciar um Logstore.
Logs de operação são gerados quando você chama esta operação.
Recursos de autenticação
A tabela a seguir lista as informações de autorização para esta operação de API. Você pode adicionar as informações ao elemento Action em uma instrução de política de acesso RAM para conceder a um usuário RAM ou função RAM as permissões para invocar esta operação de API.
| Ação | Recurso |
log:UpdateLogStore | 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:UpdateLogStore |
update |
*LogStore.
|
|
Nenhuma |
Sintaxe da solicitação
PUT /logstores/{logstore} HTTP/1.1
Parâmetros de caminho
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| logstore |
string |
Sim |
O nome do Logstore. |
test-logstore. |
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. |
test-logstore. |
shardCount
deprecated
|
integer |
Não |
O número de shards. Nota
Esta operação não suporta a atualização do número de shards. Você pode modificar 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. Um valor de 3650 indica retenção permanente. |
30 |
| encrypt_conf | EncryptConf |
Não |
A configuração de criptografia. A criptografia está desativada por padrão. Exemplo 1 (ativar criptografia padrão):
Exemplo 2 (ativar criptografia BYOK): |
|
| autoSplit |
boolean |
Não |
Especifica se o sharding automático deve ser ativado. Após a ativação desse recurso, um shard é dividido automaticamente quando o tráfego de gravação excede continuamente o limite, o que melhora a capacidade de gravação. Você deve definir maxSplitShard (o número máximo de shards após a divisão) ao ativar o sharding automático. |
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 mini programas, como visualizações de página, registros de compras e tempo no site.
|
false. |
| appendMeta |
boolean |
Não |
Especifica se o endereço IP público e a hora de chegada do log devem ser registrados. Valor padrão: false.
|
false. |
| maxSplitShard |
integer |
Não |
O número máximo de shards para sharding automático. Valor mínimo: 1. Valor máximo: 256. Nota
Este parâmetro é obrigatório quando autoSplit está definido como true. |
64 |
telemetryType
deprecated
|
string |
Não |
O tipo de dados observáveis. O valor padrão são dados de log. Valores válidos:
|
None. |
| hot_ttl |
integer |
Não |
O período de retenção de dados na camada quente do Logstore. Unidade: dias. Valor mínimo: 7. O valor não pode exceder o valor de ttl. Por padrão, todos os dados dentro do período de retenção são armazenados na camada quente. Depois que o tempo de armazenamento dos dados excede o período de retenção de dados quentes configurado, os dados são movidos para a camada de acesso pouco frequente (IA). Ao ativar a camada IA, o período de retenção de dados quentes 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 |
Camada de acesso pouco frequente (IA). Nenhum tempo mínimo de armazenamento é necessário. Os dados devem ser armazenados por pelo menos 30 dias antes de serem movidos para a camada de arquivamento. Quando o período de retenção de logs excede a soma do período de retenção da camada quente e do período de retenção da camada IA, o tempo de armazenamento restante é convertido em armazenamento na camada de arquivamento. Exemplos:
|
30 |
| shardingPolicy | ShardingPolicy |
Não |
A configuração de gravação baseada em hash. Quando os dados são gravados, os logs são roteados para shards com base na política de hash configurada. Antes de configurar este parâmetro, certifique-se de que os intervalos de hash dos shards estejam distribuídos uniformemente. Esta configuração pode afetar a capacidade de gravação. Prossiga com cautela. |
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.