全部产品
Search
文档中心

日志服务:ListDownloadJobs - 列出日志下载任务

更新时间:Nov 28, 2024

列出指定Project下的日志下载任务

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

GET /downloadjobs HTTP/1.1

请求参数

名称类型必填描述示例值
projectstring

Project 名称

ali-test-project
offsetlong

查询开始行,默认值为 0。

0
sizelong

单次查询需要获取的日志下载任务数量

10
logstorestring

Logstore 名称

ali-test-logstore

返回参数

名称类型描述示例值
object

所有的日志下载任务信息。

totalinteger

总记录数。

10
countinteger

当前列出的日志下载任务数量

10
resultsarray<object>

数组,返回日志下载任务列表

downloadJobobject

日志下载任务信息

descriptionstring

日志下载任务描述

a download job
configurationobject

下载配置

logstorestring

源 logstore

ali-test-logstore
fromTimelong

起点时间戳(精确到秒)

1722409260
toTimelong

结束时间戳(精确到秒)

1722411060
querystring

查询语句

* | select *
powerSqlboolean

是否启用 powerSql

true
allowInCompletestring

允许下载不精确结果

false
sinkobject

日志下载任务配置

compressionTypestring

压缩格式

none
contentTypestring

下载文件格式

csv
roleArnstring

下载使用 roleArn

acs:ram::123456:role/aliyunlogimportossrole
bucketstring

对象存储桶

ali-test-oss-bucket
prefixstring

下载到用户 oss bucket 时的文件前缀

download/
typestring

固定为 AliyunOSS

AliyunOSS
displayNamestring

显示名称

download-123
executionDetailsobject

执行细节

progresslong

下载进度

100
filePathstring

下载结果链接

https://sls-downloaded-xxxx.csv.gzip?Expiresxxx
fileSizelong

下载文件大小

123456
executeTimelong

下载执行时间

123
logCountlong

下载日志条数

123
errorMessagestring

下载错误信息

timeout
checkSumstring

文件 ETag

ETASFGASDASQWDasd
namestring

日志下载任务名称

download-123
createTimestring

日志下载任务创建时间

1722411060
statusstring

任务状态

STARTING、RUNNING、SUCCEEDED、ERROR

示例

正常返回示例

JSON格式

{
  "total": 10,
  "count": 10,
  "results": [
    {
      "description": "a download job",
      "configuration": {
        "logstore": "ali-test-logstore",
        "fromTime": 1722409260,
        "toTime": 1722411060,
        "query": "* | select *",
        "powerSql": true,
        "allowInComplete": "false",
        "sink": {
          "compressionType": "none",
          "contentType": "csv",
          "roleArn": "acs:ram::123456:role/aliyunlogimportossrole",
          "bucket": "ali-test-oss-bucket",
          "prefix": "download/",
          "type": "AliyunOSS"
        }
      },
      "displayName": "download-123",
      "executionDetails": {
        "progress": 100,
        "filePath": "https://sls-downloaded-xxxx.csv.gzip?Expiresxxx",
        "fileSize": 123456,
        "executeTime": 123,
        "logCount": 123,
        "errorMessage": "timeout",
        "checkSum": "ETASFGASDASQWDasd",
        "notice": ""
      },
      "name": "download-123",
      "createTime": "1722411060",
      "status": "STARTING、RUNNING、SUCCEEDED、ERROR"
    }
  ]
}

错误码

访问错误中心查看更多错误码。