Todos os produtos
Search
Central de documentação

Simple Log Service:pull_logs

Última atualização: Aug 26, 2026

Recupera logs iterativamente a partir de uma posição de cursor especificada. Use este comando para obter grandes volumes de dados de log.

Sintaxe da solicitação

aliyunlog log pull_logs --project_name=<value> --logstore_name=<value> --shard_id=<value> --cursor=<value> [--count=<value>] [--end_cursor=<value>] [--compress=<value>] [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]

Parâmetros da solicitação

Parâmetros específicos do comando:

Parameter

Type

Required

Example

Description

--project_name

String

Yes

aliyun-test-project

Nome do projeto.

--logstore_name

String

Yes

logstore-a

Nome do Logstore.

--shard_id

Integer

Yes

0

ID do shard.

--cursor

String

Yes

MTYxNDc1MDAyNzM3MzIwNTcxNA==

Posição do cursor para iniciar a leitura dos logs.

--count

Integer

No

2

Número de grupos de logs (LogGroups) a recuperar por solicitação. Um grupo de logs pode conter várias entradas; portanto, o total retornado pode exceder esse valor.

--end_cursor

String

No

MTYxNDc1MDAyNzM3MzIwNTcxNg==

Posição do cursor para interromper a leitura dos logs.

--compress

Boolean

No

true

Indica se os logs retornados devem ser compactados. Valores válidos:

  • true (padrão)

  • false

Todos os comandos da SLS CLI também suportam Global parameters.

Exemplos

  • Exemplo de solicitação

    Recupere dois grupos de logs (LogGroups) a partir de um cursor específico usando a conta padrão:

    aliyunlog log pull_logs --project_name="aliyun-test-project" --logstore_name="logstroe-a" --shard_id=0 --cursor="MTYxNDc1MDAyNzM3MzIwNTcxNA==" --count="2"
  • Exemplo de resposta

    {
      "count": 2,
      "logs": [
        {
          "__source__": "203.0.113.10",
          "__tag__:__hostname__": "iZ3s******Z",
          "__tag__:__pack_id__": "81C4812927C6B529-15DA",
          "__tag__:__receive_time__": "1619597641",
          "__time__": 1619597638,
          "__topic__": "",
          "activity_id": "",
          "computer_name": "iZ3stckpfjj7wvZ",
          "event_id": "7036",
          "kernel_time": "0",
          "keywords": "[Classic]",
          "level": "Information",
          "log_name": "System",
          "message": "The Network Setup Service service entered the stopped state.",
          "message_error": "[]",
          "opcode": "",
          "process_id": "544",
          "processor_id": "0",
          "processor_time": "0",
          "provider_guid": "{555908d1-a6d7-4695-8e1e-26931d2012f4}",
          "record_number": "8623",
          "related_activity_id": "",
          "session_id": "0",
          "source_name": "Service Control Manager",
          "task": "",
          "thread_id": "3176",
          "type": "wineventlog",
          "user_data": "{\"xml_name\":\"\"}",
          "user_time": "0",
          "version": "0"
        },
        {
          "__source__": "203.0.113.10",
          "__tag__:__hostname__": "iZ3******vZ",
          "__tag__:__pack_id__": "81C4812927C6B529-15DB",
          "__tag__:__receive_time__": "1619598347",
          "__time__": 1619598344,
          "__topic__": "",
          "activity_id": "",
          "computer_name": "iZ3stckpfjj7wvZ",
          "event_id": "7036",
          "kernel_time": "0",
          "keywords": "[Classic]",
          "level": "Information",
          "log_name": "System",
          "message": "The Windows Update service entered the running state.",
          "message_error": "[]",
          "opcode": "",
          "process_id": "544",
          "processor_id": "0",
          "processor_time": "0",
          "provider_guid": "{555908d1-a6d7-4695-8e1e-26931d2012f4}",
          "record_number": "8624",
          "related_activity_id": "",
          "session_id": "0",
          "source_name": "Service Control Manager",
          "task": "",
          "thread_id": "6868",
          "type": "wineventlog",
          "user_data": "{\"xml_name\":\"\"}",
          "user_time": "0",
          "version": "0"
        }
      ],
      "next_cursor": "MTYxNDc1MDAyNzM3MzIwNTcxNg=="
    }

Códigos de erro

Use os códigos abaixo para solucionar erros.

HttpStatusCode

ErrorCode

ErrorMessage

Description

404

LogStoreNotExist

Logstore does not exist.

O Logstore não existe.

400

ParameterInvalid

Invalid cursor.

Cursor inválido.

400

ParameterInvalid

ParameterCount should be in [0-1000].

Valor de contagem inválido. Intervalo válido: 0 a 1000.

400

ShardNotExist

Shard does not exist.

O shard não existe.

400

InternalServerError

Specified Server Error Message.

Erro interno do servidor.

Common error codes