Panggil DescribeCycleTaskList untuk menanyakan tugas scan berkala - Security Center - Alibaba Cloud - Security Center

Mengkueri daftar node terjadwal umum, termasuk node pemindaian image, pemindaian kerentanan darurat, dan pemindaian virus.

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

yundun-sas:DescribeCycleTaskList

get

*CycleTask

acs:yundun-sas:{#regionId}:{#accountId}:cycletask/{#ConfigId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
TaskName	string	No	Nama node. Nilai valid: VIRUS_VUL_SCHEDULE_SCAN: pemindaian virus. IMAGE_SCAN: pemindaian image. EMG_VUL_SCHEDULE_SCAN: pemindaian kerentanan darurat.	IMAGE_SCAN
TaskType	string	No	Tipe node. Nilai valid: VIRUS_VUL_SCHEDULE_SCAN: pemindaian virus. IMAGE_SCAN: pemindaian image. EMG_VUL_SCHEDULE_SCAN: pemindaian kerentanan darurat.	IMAGE_SCAN
CurrentPage	integer	No	Nomor halaman saat menggunakan paginasi.	1
PageSize	integer	No	Jumlah maksimum entri per halaman saat menggunakan paginasi. Nilai default: 20.	20
ConfigId	string	No	ID konfigurasi. Catatan Panggil operasi CreateCycleTask untuk mendapatkan parameter ini.	f93b6ee24cfd0aad44b897ad5051****

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan, yaitu pengidentifikasi unik yang dibuat oleh Alibaba Cloud untuk permintaan. Anda dapat menggunakan ID ini untuk memecahkan masalah.	A4EB8B1C-1DEC-5E18-BCD0-D1BBB393****
PageInfo	object	Informasi paginasi.
CurrentPage	integer	Nomor halaman saat menggunakan paginasi.	1
PageSize	integer	Jumlah maksimum entri per halaman saat menggunakan paginasi.	20
TotalCount	integer	Jumlah total entri.	149
Count	integer	Jumlah entri pada halaman saat ini saat menggunakan paginasi.	9
CycleScheduleResponseList	array<object>	Daftar tugas pemindaian siklik.
	object	Daftar tugas pemindaian siklik.
LastTaskId	string	ID tugas terakhir.	38730bb078f4a1461d4ed283994c****
ConfigId	string	ID konfigurasi.	2cdbdeba8dd70586d5814d4cbf21****
TargetEndTime	integer	Pengatur waktu akhir tugas, dalam jam.	7
NextStartTimeStr	integer	Pengatur waktu eksekusi berikutnya. Nilai berupa timestamp dalam milidetik.	1671184531000
TaskName	string	Nama tugas.	IMAGE_SCAN
TaskType	string	Tipe tugas.	IMAGE_SCAN
IntervalPeriod	integer	Periode interval.	3
FirstDateStr	integer	Pengatur waktu eksekusi pertama.	1667491200000
Param	string	Bidang informasi tambahan.	{"userAgreement":"yes","lang":"zh"}
PeriodUnit	string	Unit periode pemindaian. Nilai valid: day: hari. hour: jam.	day
TargetStartTime	integer	Pengatur waktu mulai tugas, dalam jam.	0
Enable	integer	Apakah tugas diaktifkan. Nilai valid: 1: diaktifkan. 0: dinonaktifkan.	1

Contoh

Respons sukses

JSONformat

{
  "RequestId": "A4EB8B1C-1DEC-5E18-BCD0-D1BBB393****",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 149,
    "Count": 9
  },
  "CycleScheduleResponseList": [
    {
      "LastTaskId": "38730bb078f4a1461d4ed283994c****",
      "ConfigId": "2cdbdeba8dd70586d5814d4cbf21****",
      "TargetEndTime": 7,
      "NextStartTimeStr": 1671184531000,
      "TaskName": "IMAGE_SCAN",
      "TaskType": "IMAGE_SCAN",
      "IntervalPeriod": 3,
      "FirstDateStr": 1667491200000,
      "Param": "{\"userAgreement\":\"yes\",\"lang\":\"zh\"}",
      "PeriodUnit": "day",
      "TargetStartTime": 0,
      "Enable": 1
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	RdCheckNoPermission	Resource directory account verification has no permission.	The resource directory account does not have permission.
500	ServerError	ServerError	Service failure. Try again later.
500	RdCheckInnerError	Resource directory account service internal error.	An internal error occurred in the resource directory account service.
403	NoPermission	caller has no permission	The current operation is not authorized. Contact the Alibaba Cloud account to authorize the operation in the RAM console before performing the operation.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.