Todos os produtos
Search
Central de documentação

Simple Log Service:GetProjectLogs

Última atualização: Jun 28, 2026

Consulta logs em um projeto. Você pode usar esta operação para consultar logs no nível do projeto.

Descrição da operação

Notas de uso

  • Host consiste em um nome de projeto e um endpoint do Simple Log Service. Você deve especificar um projeto em Host.

  • Um par de AccessKey foi criado e obtido. Para mais informações, consulte Par de AccessKey.

O par de AccessKey de uma conta Alibaba Cloud possui permissões em todas as operações de API. Usar essas credenciais para realizar operações no Simple Log Service é uma operação de alto risco. Recomendamos que você use um usuário Resource Access Management (RAM) para chamar operações de API ou realizar O&M de rotina. Para criar um usuário RAM, faça login no console do RAM. Certifique-se de que o usuário RAM tenha as permissões de gerenciamento nos recursos do Simple Log Service. Para mais informações, consulte Criar um usuário RAM e autorizar o usuário RAM a acessar o Simple Log Service.

  • As informações necessárias para consultar logs foram obtidas. As informações incluem o nome do projeto ao qual os logs pertencem e a região do projeto. Para mais informações, consulte Gerenciar um projeto.

  • Os índices são configurados antes de você consultar logs. Para mais informações, consulte Criar índices.

  • Limites são impostos quando você usa o Simple Log Service para consultar logs. Recomendamos que você especifique instruções de consulta e intervalos de tempo de consulta com base nos limites. Para mais informações, consulte Visão geral da pesquisa de logs e Visão geral da análise de logs.

  • Você deve definir query como uma instrução SQL padrão.

  • Você deve especificar um Logstore na cláusula FROM de uma instrução SQL. Um Logstore pode ser usado como uma tabela SQL.

  • Você deve especificar um intervalo de tempo em uma instrução SQL usando o parâmetro __date__ ou __time__. O valor do parâmetro __date__ é um timestamp. O valor do parâmetro __time__ é um inteiro, e a unidade do valor é segundos.

Recursos de autenticação

A tabela a seguir descreve as informações de autorização necessárias para esta operação. Você pode adicionar as informações ao elemento Action de uma declaração de política RAM para conceder a um usuário RAM ou a uma função RAM as permissões para chamar esta operação.

ActionResource
log:GetProjectLogsacs:log:{#regionId}:{#accountId}:project/{#ProjectName}

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

GET /logs 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

query

string

Sim

A instrução SQL padrão. Neste exemplo, a instrução SQL consulta o número de visualizações de página (PVs) de 2022-03-01 10:41:40 a 2022-03-01 10:56:40 em um Logstore cujo nome é nginx-moni.

SELECT COUNT(*) as pv FROM nginx-moni where __time__ > 1646102500 and __time__ < 1646103400

powerSql

boolean

Não

Especifica se o recurso Dedicated SQL deve ser ativado. Para mais informações, consulte Ativar Dedicated SQL. Valores válidos:

  • true

  • false (padrão): ativa o recurso Standard SQL.

Você pode usar o parâmetro powerSql ou query para configurar o Dedicated SQL.

false

Exemplos de solicitações

GET /logs?query=SELECT COUNT(*) as pv FROM nginx-moni where time > 1646102500 and time < 1646103400&powerSql=false HTTP/1.1 Host:ali-test-project.ch-hangzhou.log.aliyuncs.com Content-Type:application/json.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

array

Os logs retornados.

object

O log retornado.

[ { "__time__" : 1409529660, "__source__" : "192.168.1.100", "Key1" : "error", "Key2" : "Value2" }, { "__time__" : 1409529680, "__source__" : "192.168.1.100", "Key3" : "error", "Key4" : "Value4" } ]

string

O log retornado.

[ { "__time__" : 1409529660, "__source__" : "192.168.1.100", "Key1" : "error", "Key2" : "Value2" }, { "__time__" : 1409529680, "__source__" : "192.168.1.100", "Key3" : "error", "Key4" : "Value4" } ]

Exemplos

Resposta de sucesso

JSON formato

[
  {
    "key": "[ { \"__time__\" : 1409529660, \"__source__\" : \"192.168.1.100\", \"Key1\" : \"error\", \"Key2\" : \"Value2\" }, { \"__time__\" : 1409529680, \"__source__\" : \"192.168.1.100\", \"Key3\" : \"error\", \"Key4\" : \"Value4\" } ]"
  }
]

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.