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

Descrição da operação

Aviso O SDK do OpenAPI não oferece suporte a esta operação. Use o SDK do Simple Log Service em seu lugar.

Você deve especificar um shard ao obter logs.
Apenas dados no formato Protocol Buffer são suportados.
O Host na sintaxe da solicitação consiste no nome do projeto e no endpoint do Simple Log Service. Especifique o projeto no Host.

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}/shards/{shardId}?type=log HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
logStore	string	Sim	O nome do Logstore.	ali-test-logstore
shardId	integer	Sim	O ID do shard no Logstore.	1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
project	string	Sim	O nome do projeto.	ali-test-project
cursor	string	Sim	O cursor que indica a posição inicial a partir da qual ler os dados.	MTQ0NzMyOTQwMTEwMjEzMDkwNA
count	integer	Sim	O número máximo de grupos de logs a serem retornados. Valor mínimo: 1. Valor máximo: 1000.	1000
end_cursor	string	Não	O cursor final que indica a posição na qual parar de ler os dados. Os dados nesta posição não estão incluídos.	MTU1NzA1NzQwMTEwMjEzMDkwCg
query	string	Não	A instrução de filtro na sintaxe SPL. Para mais informações, consulte instruções SPL.	* \| where userId='123'
Accept-Encoding	string	Não	O formato de compactação esperado dos dados retornados pelo servidor. O valor lz4 é suportado.	lz4

Os seguintes cabeçalhos de solicitação são específicos da operação PullLogs:

Accept: application/x-protobuf
Accept-Encoding: lz4

O valor de Accept-Encoding pode ser lz4, deflate ou aspas duplas ("").

Exemplo de solicitação:

GET /logstores/sls-test-logstore/shards/0?type=logs&cursor=MTQ0NzMyOTQwMTEwMjEzMDkwNA&count=1000 HTTP/1.1
Host:ali-test-project.cn-hangzhou.log.aliyuncs.com
Content-Type:application/json

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	LogGroupList	Os dados compactados do Protocol Buffer.

Os seguintes elementos de resposta são específicos da operação PullLogs:

x-log-cursor: O cursor para a próxima entrada após a leitura dos dados atuais.
x-log-end-of-cursor: O cursor para a última entrada da leitura dos dados atuais.
x-log-count: O número de entradas retornadas.

Para obter informações sobre os cabeçalhos de resposta comuns da API do Simple Log Service, consulte Cabeçalhos de resposta comuns.

Os elementos de resposta são dados serializados no formato Protocol Buffer, que podem estar compactados.

Exemplos

Resposta de sucesso

JSON formato

{
  "logGroupList": [
    {
      "LogItems": [
        {
          "Contents": [
            {
              "Key": "key-test",
              "Value": "value-test"
            }
          ],
          "Time": 1690254376,
          "TimeNs": 123456789
        }
      ],
      "LogTags": [
        {
          "Key": "key-test",
          "Value": "value-test"
        }
      ],
      "Source": "192.1.1.1",
      "Topic": "topic-test"
    }
  ]
}

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.