Todos os produtos
Search
Central de documentação

Simple Log Service:UpdateLogStore

Última atualização: Jul 24, 2026

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.

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çãoRecurso
log:UpdateLogStoreacs:log:{#regionId}:{#accountId}:project/{#ProjectName}/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:UpdateLogStore

update

*LogStore.

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

  • log:TLSVersion
  • log:Encrypted
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):

{
    "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": "ap-southeast-1"
    }
}

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.

  • true: ativa o WebTracking.

  • false: desativa o WebTracking.

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.

  • true: ativa o recurso. Após a ativação desse recurso, o Simple Log Service adiciona automaticamente o endereço IP público do dispositivo de origem do log e a hora em que o log chega ao servidor ao campo Tag do log.

  • false: desativa o recurso.

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: dados de log. Este é o valor padrão.

  • Metrics: dados de séries temporais.

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:

  • Cenário 1 (apenas camada quente, 30 dias): {"ttl": 30} ou {"ttl": 30, "hot_ttl": 30}

  • Cenário 2 (camada quente 7 dias, camada IA 23 dias): {"ttl": 30, "hot_ttl": 7}

60

mode

string

Não

O Simple Log Service fornece dois tipos de Logstores: Standard e Query.

  • standard: suporta capacidades de análise de dados completas do Simple Log Service. Este tipo é adequado para cenários como monitoramento em tempo real, análise interativa e construção de sistemas completos de observabilidade.

  • query: suporta consultas de alto desempenho. A taxa de tráfego de índice é aproximadamente metade da do tipo Standard. No entanto, a análise SQL não é suportada. Este tipo é adequado para cenários com grandes volumes de dados, longos períodos de armazenamento (semanas ou meses) e sem requisitos de análise de logs.

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:

  • Cenário 1 (camada quente 7 dias, camada IA 23 dias): {"ttl": 30, "hot_ttl": 7}

  • Cenário 2 (camada quente 7 dias, camada IA 30 dias, camada de arquivamento 60 dias): {"ttl": 97, "hot_ttl": 7, "infrequentAccessTTL": 30}

  • Cenário 3 (camada quente 60 dias, camada IA 0 dias, camada de arquivamento 60 dias): {"ttl": 120, "hot_ttl": 60, "infrequentAccessTTL": 0}

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.