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

Mendaftar tugas 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

*Semua Sumber daya

*

None

Sintaks permintaan

GET /downloadjobs HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
project	string	Yes	Nama Proyek.	ali-test-proyek
offset	integer	No	Baris awal kueri. Nilai default: 0.	0
size	integer	No	Jumlah tugas unduhan log yang diambil dalam satu kueri.	10
logstore	string	No	Nama penyimpanan log.	ali-test-logstore.

Elemen respons

Element	Type	Description	Example
	object	Informasi tentang semua tugas unduhan log.
total	integer	Jumlah total rekaman.	10
count	integer	Jumlah tugas unduhan log yang dikembalikan dalam permintaan saat ini.	10
results	array<object>	Daftar tugas unduhan log.
	array<object>	Informasi tugas unduhan log.
description	string	Deskripsi tugas unduhan log.	tugas unduhan.
configuration	object	Konfigurasi unduhan.
logstore	string	The source Logstore.	ali-test-logstore
fromTime	integer	The start time of the query. The value is a UNIX timestamp that is accurate to the second.	1722409260
toTime	integer	The end time of the query. The value is a UNIX timestamp that is accurate to the second.	1722411060
query	string	The query statement.	* \| select *
powerSql	boolean	Specifies whether to enable PowerSQL.	true
allowInComplete	string	Specifies whether to allow the download of incomplete results.	false
sink	object	The sink configuration.
compressionType	string	The compression format.	none
contentType	string	The file 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 Object Storage Service (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. Set the value to AliyunOSS.	AliyunOSS
displayName	string	Nama tampilan.	download-123
executionDetails	object	Detail eksekusi.
progress	integer	The download progress in percentage.	100
filePath	string	The URL of the downloaded file.	https://sls-downloaded-xxxx.csv.gzip?Expiresxxx
fileSize	integer	The size of the downloaded file. Unit: bytes.	123456
executeTime	integer	The running time of the download.	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	The notification message.	test
name	string	Nama tugas unduhan log.	download-123
createTime	string	Pengatur waktu pembuatan tugas unduhan log.	1722411060
status	string	Status Tugas.	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.