Referensi API GetDownloadJob untuk Pekerjaan Unduhan Log - Simple Log Service - Alibaba Cloud - Simple Log Service

Mengambil informasi tentang tugas unduh.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

GET /downloadjobs/{downloadJobName} HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
downloadJobName	string	Yes	Nama tugas unduh log.	download-123

Parameter permintaan

Parameter	Type	Required	Description	Example
project	string	Yes	Nama proyek.	ali-test-project

Elemen respons

Element	Type	Description	Example
	object	The information about the download job.
status	string	The status of the download task.	STARTING、RUNNING、SUCCEEDED、ERROR
name	string	The name of the download task.	download-123
description	string	The description of the task.	a download job
configuration	object	The download configuration.
logstore	string	The source Logstore.	ali-test-logstore
fromTime	integer	The start time of the download task. The value is a UNIX timestamp in seconds.	1722409860
toTime	integer	The end time of the download task. The value is a UNIX timestamp in seconds.	1722411060
query	string	The search statement.	* \| select *
powerSql	boolean	Specifies whether to enable PowerSQL.	false
allowInComplete	boolean	Specifies whether to allow downloading incomplete data. Valid values: true : yes false : no	true
sink	object	The export configuration.
type	string	The value is fixed to AliyunOSS.	AliyunOSS
contentType	string	The file format.	csv
compressionType	string	The compression format.	none
roleArn	string	The Alibaba Cloud Resource Name (ARN) of the RAM role that is used for the download.	acs:ram::0123456789:role/aliyunlogdefaultrole
bucket	string	The Object Storage Service (OSS) bucket.	ali-test-oss-bucket
prefix	string	The prefix of the file that is saved to the bucket.	download/
createTime	string	The time when the task was created.	1722411060
displayName	string	The display name.	download-123456
executionDetails	object	The execution details.
progress	integer	The download progress.	100
filePath	string	The URL of the download result.	https://xxx.csv.zst?xxx
fileSize	integer	The size of the downloaded file in bytes.	123456
executeTime	integer	The duration of the download task in seconds.	123
logCount	integer	The number of downloaded log entries.	123
errorMessage	string	The error message if the download fails.	timeout
checkSum	string	The ETag of the file.	EXSFGSDASDASDG123ASD
notice	string

Contoh

Respons sukses

JSONformat

{
  "status": "STARTING、RUNNING、SUCCEEDED、ERROR",
  "name": "download-123",
  "description": "a download job",
  "configuration": {
    "logstore": "ali-test-logstore",
    "fromTime": 1722409860,
    "toTime": 1722411060,
    "query": "* | select *",
    "powerSql": false,
    "allowInComplete": true,
    "sink": {
      "type": "AliyunOSS",
      "contentType": "csv",
      "compressionType": "none",
      "roleArn": "acs:ram::0123456789:role/aliyunlogdefaultrole",
      "bucket": "ali-test-oss-bucket",
      "prefix": "download/"
    }
  },
  "createTime": "1722411060",
  "displayName": "download-123456",
  "executionDetails": {
    "progress": 100,
    "filePath": "https://xxx.csv.zst?xxx",
    "fileSize": 123456,
    "executeTime": 123,
    "logCount": 123,
    "errorMessage": "timeout",
    "checkSum": "EXSFGSDASDASDG123ASD",
    "notice": ""
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.