Kueri Pekerjaan Unduhan Log melalui API ListDownloadJobs - Simple Log Service - Alibaba Cloud - Simple Log Service

Menampilkan daftar pekerjaan unduhan log dalam proyek tertentu.

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

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

log:ListDownloadJobs

list

*全部资源

*

None

Sintaks permintaan

GET /downloadjobs HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
project	string	Yes	Nama proyek.	ali-test-project
offset	integer	No	Baris tempat memulai kueri. Nilai default: 0.	0
size	integer	No	Jumlah pekerjaan unduhan log yang dikembalikan dalam satu permintaan.	10
logstore	string	No	Nama penyimpanan log.	ali-test-logstore

Elemen respons

Element	Type	Description	Example
	object	The information about all log download jobs.
total	integer	The total number of records.	10
count	integer	The number of log download jobs returned in the current response.	10
results	array<object>	An array that consists of the list of log download jobs.
	array<object>	The information about a log download job.
description	string	The description of the log download job.	a download job
configuration	object	The download configuration.
logstore	string	The source Logstore.	ali-test-logstore
fromTime	integer	The start of the time range to query. This is a UNIX timestamp in seconds.	1722409260
toTime	integer	The end of the time range to query. This is a UNIX timestamp in seconds.	1722411060
query	string	The query statement.	* \| select *
powerSql	boolean	Indicates whether PowerSQL is enabled.	true
allowInComplete	string	Indicates whether to allow the download of incomplete query results.	false
sink	object	The sink configuration.
compressionType	string	The compression format.	none
contentType	string	The format of the downloaded file.	csv
roleArn	string	The Alibaba Cloud Resource Name (ARN) of the RAM role that is used for the download.	acs:ram::123456:role/aliyunlogimportossrole
bucket	string	The destination OSS bucket.	ali-test-oss-bucket
prefix	string	The prefix of the object that is downloaded to the destination OSS bucket.	download/
type	string	The type of the sink. The value is fixed as AliyunOSS.	AliyunOSS
displayName	string	The display name.	download-123
executionDetails	object	The execution details of the job.
progress	integer	The download progress. Unit: %.	100
filePath	string	The URL of the downloaded file.	https://sls-downloaded-xxxx.csv.gzip?Expiresxxx
fileSize	integer	The size of the downloaded file in bytes.	123456
executeTime	integer	The running time of the download in seconds.	123
logCount	integer	The number of downloaded log entries.	123
errorMessage	string	The error message that is returned if the job fails.	timeout
checkSum	string	The ETag of the file.	ETASFGASDASQWDasd
notice	string		test
name	string	The name of the log download job.	download-123
createTime	string	The time when the log download job was created. The value is a UNIX timestamp in seconds.	1722411060
status	string	The status of the job.	STARTING、RUNNING、SUCCEEDED、ERROR

Contoh

Respons sukses

JSONformat

{
  "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": "test"
      },
      "name": "download-123",
      "createTime": "1722411060",
      "status": "STARTING、RUNNING、SUCCEEDED、ERROR"
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.