Ikhtisar API DescribeGroupedMaliciousFiles - Security Center - Alibaba Cloud - Security Center

Mengkueri daftar file sampel berbahaya dalam gambar kontainer.

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:DescribeGroupedMaliciousFiles

get

*All Resources

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Lang	string	No	Bahasa permintaan dan tanggapan. Nilai default: zh. Nilai valid: zh: Bahasa Mandarin en: Bahasa Inggris.	zh
Levels	string	No	Tingkat keparahan sampel berbahaya dalam gambar kontainer yang ingin Anda kueri. Pisahkan beberapa nilai dengan koma (,). Nilai valid: serious: mendesak suspicious: mencurigakan remind: pengingat.	serious
FuzzyMaliciousName	string	No	Nama file berbahaya yang ingin Anda kueri. Catatan Pencocokan kabur didukung.	Mining
CurrentPage	integer	Yes	Nomor halaman yang akan dikembalikan. Nilai minimum: 1. Nilai default: 1, yang menunjukkan bahwa halaman pertama dikembalikan.	1
PageSize	string	Yes	Jumlah entri maksimum per halaman dalam kueri penomoran halaman. Nilai default: 20.	20
RepoRegionId	string	No	ID wilayah repository image. Nilai valid: cn-beijing: Tiongkok (Beijing) cn-zhangjiakou: Tiongkok (Zhangjiakou) cn-hangzhou: Tiongkok (Hangzhou) cn-shanghai: Tiongkok (Shanghai) cn-shenzhen: Tiongkok (Shenzhen) cn-hongkong: Hong Kong (Tiongkok) ap-southeast-1: Singapura ap-southeast-5: Indonesia (Jakarta) us-east-1: AS (Virginia) us-west-1: AS (Silicon Valley) eu-central-1: Jerman (Frankfurt) eu-west-1: Inggris (London).	cn-shanghai
RepoInstanceId	string	No	ID instans gambar kontainer. Catatan Panggil operasi ListRepository dari Container Registry untuk mendapatkan nilai parameter respons InstanceId.	cri-datvailb****
RepoId	string	No	ID repository image. Catatan Panggil operasi ListRepository dari Container Registry untuk mendapatkan nilai parameter respons RepoId.	crr-vridcl4****
RepoName	string	No	Nama repository image. Catatan Pencocokan kabur didukung.	centos
RepoNamespace	string	No	Namespace repository image. Catatan Pencocokan kabur didukung.	hanghai-namespace
ImageTag	string	No	Tag image.	0.2
ImageDigest	string	No	Digest image.	6a5e103187b31a94592a47a5858617f7****
ImageLayer	string	No	Layer image.	27213ad375b53628dd152a5ca****
ClusterId	string	No	ID kluster server tempat Anda ingin mengkueri peristiwa pengecualian.	c556c8133b5ad4378b7fc533ddbda****
ScanRange	array	No	Kumpulan rentang pemindaian.
	string	No	Rentang pemindaian. Nilai valid: container: kontainer image: image.	container
MaliciousMd5	string	No	Hash MD5 file berbahaya.	d836968041f7683b5459****

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
RequestId	string	ID permintaan, yaitu pengidentifikasi unik yang dibuat oleh Alibaba Cloud untuk permintaan tersebut. Anda dapat menggunakan ID ini untuk memecahkan masalah.	8045E03E-6D91-4C53-9F22-5A1B84BB29D9
PageInfo	object	Informasi penomoran halaman.
CurrentPage	integer	Nomor halaman saat ini dalam kueri penomoran halaman.	1
PageSize	integer	Jumlah entri maksimum per halaman dalam kueri penomoran halaman. Nilai default: 20.	20
TotalCount	integer	Jumlah total file sampel berbahaya.	2
Count	integer	Jumlah file sampel berbahaya yang dikembalikan pada halaman saat ini.	2
GroupedMaliciousFileResponse	array<object>	Daftar file sampel berbahaya.
	object	Informasi tentang file sampel berbahaya dalam gambar kontainer.
Status	integer	Status penanganan sampel berbahaya dalam gambar kontainer. Nilai valid: 0: Belum ditangani. 1: Ditangani. 2: Memverifikasi. 3: Masuk daftar putih.	0
ImageCount	integer	Jumlah image yang terpengaruh oleh sampel berbahaya.	3
LatestScanTimestamp	integer	Timestamp pemindaian terbaru. Unit: milidetik.	1596533942000
MaliciousName	string	Nama file berbahaya.	testFile
MaliciousMd5	string	Hash MD5 file berbahaya.	d836968041f7683b5459****
FirstScanTimestamp	integer	Timestamp pemindaian pertama. Unit: milidetik.	1594907349000
Level	string	Tingkat keparahan sampel berbahaya dalam gambar kontainer. Nilai valid: serious: mendesak suspicious: mencurigakan remind: pengingat.	serious
MaliciousKey	string	Kata kunci file berbahaya.	WEBSHELL_IMG

Contoh

Respons sukses

JSONformat

{
  "RequestId": "8045E03E-6D91-4C53-9F22-5A1B84BB29D9",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 2,
    "Count": 2
  },
  "GroupedMaliciousFileResponse": [
    {
      "Status": 0,
      "ImageCount": 3,
      "LatestScanTimestamp": 1596533942000,
      "MaliciousName": "testFile",
      "MaliciousMd5": "d836968041f7683b5459****",
      "FirstScanTimestamp": 1594907349000,
      "Level": "serious",
      "MaliciousKey": "WEBSHELL_IMG"
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
500	ServerError	ServerError	Service failure. Try again later.
403	NoPermission	caller has no permission	The current operation is unauthorized. Contact your Alibaba Cloud account to grant the required permissions in the RAM console before you perform this operation.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.