GetContextLogs - Simple Log Service: Central de Documentação do Alibaba Cloud

Descrição da operação

Notas de uso

Você pode especificar um log como o log inicial. O intervalo de tempo de uma consulta contextual é de um dia antes e um dia depois do horário de geração do log inicial.
O Host consiste em um nome de projeto e um endpoint do Simple Log Service. Você deve especificar um projeto no 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 tem 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 do 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 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, a região do projeto e o nome do Logstore ao qual os logs pertencem. Para mais informações, consulte Gerenciar um projeto e Gerenciar um Logstore.
Os índices são configurados antes de você consultar os logs. Para mais informações, consulte Criar índices.
Os valores dos campos pack_id e pack_meta são obtidos antes de você consultar os logs. Os campos são campos internos e você pode obter os valores usando o recurso de depuração do seu navegador no console do Simple Log Service.

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 instruçã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.

Action	Resource
`log:GetLogStoreContextLogs`	`acs: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

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 /logstores/{logstore}?type=context_log 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
pack_id	string	Sim	O identificador exclusivo do grupo de logs ao qual o log inicial pertence.	85C897C740352DC6-808
pack_meta	string	Sim	O identificador de contexto exclusivo do log inicial no grupo de logs.	2\|MTY1NTcwNTUzODY5MTY0MDk1Mg==\|3\|0
back_lines	integer	Sim	O número de logs que você deseja obter e que são gerados antes do horário de geração do log inicial. Valores válidos: `(0,100]`.	10
forward_lines	integer	Sim	O número de logs que você deseja obter e que são gerados após o horário de geração do log inicial. Valores válidos: `(0,100]`.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
total_lines	integer	O número total de logs retornados. Os logs incluem o log inicial especificado na solicitação.	201
back_lines	integer	O número de logs gerados antes do horário de geração do log inicial.	100
forward_lines	integer	O número de logs gerados após o horário de geração do log inicial.	100
progress	string	Indica se os resultados da consulta e da análise estão completos. Valores válidos: Complete: A consulta foi bem-sucedida e os resultados completos da consulta e da análise são retornados. Incomplete: A consulta foi bem-sucedida, mas os resultados da consulta e da análise estão incompletos. Para obter os resultados completos, você deve repetir a solicitação.	Complete
logs	array<object>	Os logs retornados.
	object	Os logs retornados. Os logs são organizados em ordem contextual. Se nenhum log contextual for encontrado com base no log inicial especificado, este parâmetro estará vazio.	{ "__index_number__": "-100", "__tag__:__pack_id__": "895CEA449A52FE-8c8", "__pack_meta__": "0\|MTU1OTI4NTExMjg3NTQ2NDU1OA==\|4\|1"}

O parâmetro logs contém o conteúdo do log e os seguintes campos formatados em pares chave-valor.

Campo	Tipo	Exemplo	Descrição
`__index_number__`	String	-100	A posição do log no contexto. Um valor negativo indica que o log é gerado antes do horário de geração do log inicial. O valor 0 indica que o log é o log inicial. Um valor positivo indica que o log é gerado após o horário de geração do log inicial. Por exemplo, o valor -100 indica que o log é o 100º log antes do horário de geração do log inicial.
`__tag__:__pack_id__`	String	895CEA449A52FE-8c8	O identificador exclusivo do grupo de logs ao qual o log pertence. O identificador pode ser usado como o valor do parâmetro pack_id na solicitação.
`__pack_meta__`	String	`0	MTU1OTI4NTExMjg3NTQ2NDU1OA==

Exemplos

Resposta de sucesso

JSON formato

{
  "total_lines": 201,
  "back_lines": 100,
  "forward_lines": 100,
  "progress": "Complete",
  "logs": [
    {
      "__index_number__": "-100",
      "__tag__:__pack_id__": "895CEA449A52FE-8c8",
      "__pack_meta__": "0|MTU1OTI4NTExMjg3NTQ2NDU1OA==|4|1"
    }
  ]
}

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.