Ringkasan API DescribeGroupedInstances untuk Pengelompokan Aset - Security Center - Alibaba Cloud - Security Center

Mengkueri statistik aset berdasarkan dimensi agregasi yang ditentukan.

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

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Lang	string	No	Jenis bahasa untuk permintaan dan tanggapan. Nilai default: zh. Nilai valid: zh: Bahasa Tionghoa. en: Bahasa Inggris.	zh
MachineTypes	string	No	Jenis aset yang akan dikueri. Nilai tetap: ecs, menunjukkan instans Elastic Compute Service (ECS).	ecs
GroupField	string	Yes	Kondisi filter untuk mengkueri aset. Nilai valid: groupId: mengkueri aset berdasarkan kelompok. regionId: mengkueri aset berdasarkan wilayah. vpcInstanceId: mengkueri aset berdasarkan Virtual Private Cloud (VPC).	groupId
FieldValue	string	No	Nama kelompok aset yang akan dikueri. Pencarian fuzzy didukung.	test-01
NoPage	boolean	No	Apakah akan mengaktifkan kueri terpaginasi. Nilai default: true. Nilai valid: true: Mengaktifkan kueri terpaginasi. false: Menonaktifkan kueri terpaginasi.	true
PageSize	integer	No	Jumlah entri per halaman dalam kueri terpaginasi. Nilai default: 20, menunjukkan bahwa 20 entri informasi aset ditampilkan per halaman.	20
CurrentPage	integer	No	Nomor halaman tempat hasil kueri mulai ditampilkan. Nilai default: 1, menunjukkan bahwa hasil kueri ditampilkan mulai dari halaman 1.	1
Vendor	integer	No	Vendor server. Nilai valid: 0: Aset Alibaba Cloud. 1: Aset non-cloud. 2: Aset IDC. 3, 4, 5, 7: Aset dari penyedia cloud lain. 8: Aset ringan.	0
Vendors	string	No	Vendor server. Pisahkan beberapa vendor dengan koma (,). Nilai valid: 0: Aset Alibaba Cloud. 1: Aset non-cloud. 2: Aset IDC. 3, 4, 5, 7: Aset dari penyedia cloud lain. 8: Aset ringan.	0,8
SaleVersionCheckCode	string	No	Filter edisi untuk mengkueri aset. Nilai valid: sas_gte_advanced: Edisi Lanjutan atau lebih tinggi. sas_gte_enterprise: Edisi Perusahaan atau lebih tinggi. sas_gt_basic: Edisi berbayar. sas_eq_advanced: Hanya Edisi Lanjutan. sas_gt_anti_virus: Edisi lebih tinggi dari Edisi Anti-virus.	sas_gt_basic

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan, yaitu pengenal unik yang dibuat oleh Alibaba Cloud untuk permintaan. Anda dapat menggunakan ID ini untuk memecahkan masalah.	52A3AEE6-114A-499D-8990-4BA9B27FE0AA
PageInfo	object	Informasi paginasi dari hasil kueri.
CurrentPage	integer	Nomor halaman saat ini dalam kueri terpaginasi.	5
PageSize	integer	Jumlah entri per halaman dalam kueri terpaginasi. Nilai default: 20, menunjukkan bahwa 20 entri informasi aset ditampilkan per halaman.	20
TotalCount	integer	Jumlah total entri aset yang dikembalikan.	100
Count	integer	Jumlah entri aset yang ditampilkan pada halaman saat ini dalam kueri terpaginasi.	20
Instances	array<object>	Daftar informasi aset yang dikembalikan.
	object	Informasi aset.
AsapVulInstanceCount	integer	Jumlah aset yang memiliki kerentanan tingkat tinggi.	11
UnProtectedInstanceCount	string	Jumlah aset yang tidak dilindungi oleh Pusat Keamanan.	32
FieldAliasName	string	Nama kelompok server.	testA
InstanceCount	string	Jumlah total aset dari jenis aset yang ditentukan. Catatan Jika parameter permintaan MachineTypes tidak diatur, nilai parameter ini adalah jumlah total aset dari semua jenis.	205
RiskInstanceCount	string	Jumlah aset yang memiliki risiko keamanan.	172
GroupFlag	integer	Jenis kelompok server. Nilai valid: 0: kelompok default 1: kelompok lain.	1
AuthVersionCheckCount	integer	Jumlah aset yang memenuhi persyaratan edisi.	205
Os	string	Jenis sistem operasi aset. Nilai valid: windows linux Penting Bidang ini hanya dikembalikan ketika Lang diatur ke zh. .	windows
InstanceCoreCount	integer	Jumlah total core komputasi dari semua aset pada jenis aset yang ditentukan. Catatan Jika parameter permintaan MachineTypes tidak diatur, nilai parameter ini adalah jumlah total core komputasi aset dari semua jenis.	610

Contoh

Respons sukses

JSONformat

{
  "RequestId": "52A3AEE6-114A-499D-8990-4BA9B27FE0AA",
  "PageInfo": {
    "CurrentPage": 5,
    "PageSize": 20,
    "TotalCount": 100,
    "Count": 20
  },
  "Instances": [
    {
      "AsapVulInstanceCount": 11,
      "UnProtectedInstanceCount": "32",
      "FieldAliasName": "testA",
      "InstanceCount": "205",
      "RiskInstanceCount": "172",
      "GroupFlag": 1,
      "AuthVersionCheckCount": 205,
      "Os": "windows",
      "InstanceCoreCount": 610
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	NoPermission	no permission	无此服务的访问权限。
500	ServerError	ServerError	服务故障，请稍后重试！
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.