Referensi API DescribeGroupedContainerInstances - Security Center

Melakukan kueri terhadap kontainer berdasarkan tipe grup.

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
Criteria	string	No	Kondisi pencarian untuk aset. Tentukan nilainya dalam format JSON. Pisahkan beberapa kondisi pencarian dengan koma (,). Contoh: `[{"name":"riskStatus","value":"YES"},{"name":"riskLevel","value":"2"}]`. Catatan Kondisi pencarian yang didukung mencakup ID instans, nama instans, ID virtual private cloud (VPC), wilayah, dan alamat IP publik. Anda dapat memanggil operasi DescribeCriteria untuk mengkueri kondisi pencarian yang didukung.	[{"name":"riskStatus","value":"YES"},{"name":"riskLevel","value":"2"}]
LogicalExp	string	No	Hubungan logis yang ingin Anda gunakan untuk mengevaluasi beberapa kondisi pencarian. Nilai yang valid: OR: Kondisi pencarian dievaluasi menggunakan logika OR. AND: Kondisi pencarian dievaluasi menggunakan logika AND.	OR
GroupField	string	Yes	Tipe grup yang ingin Anda gunakan untuk mengkueri kontainer. Nilai yang valid: pod appName namespace clusterId image	pod
FieldValue	string	No	Kata kunci yang ingin Anda gunakan untuk mengkueri kontainer. Parameter ini bergantung pada nilai parameter GroupField. Jika parameter GroupField diatur ke pod, atur parameter ini ke nama pod yang ingin Anda kueri. Jika parameter GroupField diatur ke appName, atur parameter ini ke nama aplikasi yang ingin Anda kueri. Jika parameter GroupField diatur ke namespace, atur parameter ini ke namespace yang ingin Anda kueri. Jika parameter GroupField diatur ke clusterId, atur parameter ini ke ID kluster yang ingin Anda kueri. Jika parameter GroupField diatur ke image, atur parameter ini ke nama gambar yang ingin Anda kueri. Catatan Pencocokan fuzzy didukung.	cas-adad-qeqwe
PageSize	integer	No	Jumlah entri yang dikembalikan per halaman. Nilai default: 20. Catatan Kami menyarankan agar Anda tidak mengosongkan parameter ini.	20
CurrentPage	integer	No	Nomor halaman yang dikembalikan. Nilai default: 1.	1

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan, yang digunakan untuk melacak dan memecahkan masalah.	4E5BFDCF-B9DD-430D-9DA4-151BCB581C9D
PageInfo	object	Informasi paginasi.
CurrentPage	integer	Nomor halaman yang dikembalikan.	1
PageSize	integer	Jumlah entri yang dikembalikan per halaman. Nilai default: 20.	20
TotalCount	integer	Total jumlah aset kontainer yang dikembalikan.	25
Count	integer	Jumlah aset kontainer yang dikembalikan pada halaman saat ini.	20
GroupedContainerInstanceList	array<object>	Informasi mengenai kontainer.
	object
RiskLevel	string	Tingkat risiko. Nilai yang valid: high medium low	low
HostIp	string	Alamat IP host dalam kluster kontainer.	172.114.XX.XX
Pod	string	Nama pod.	csi-plugin-2n****
RiskStatus	string	Menunjukkan apakah risiko terdeteksi. Nilai yang valid: NO YES	NO
CreateTime	integer	Timestamp saat kluster dibuat. Satuan: milidetik.	1600076893000
Namespace	string	Namespace kluster.	kube-system
CusterState	string	Status kluster. Nilai yang valid: running: Kluster sedang berjalan. stopped: Kluster dihentikan. deleted: Kluster dihapus. delete_failed: Penghapusan kluster gagal. failed: Pembuatan kluster gagal.	running
InstanceId	string	ID server.	i-8vb9ul5xec4tua4q****
RegionId	string	ID wilayah instans.	cn-hangzhou
AppName	string	Nama aplikasi.	oss-liveness-probe
InstanceCount	integer	Jumlah pod, aplikasi, kluster, atau namespace.	9
ClusterType	string	Tipe kluster. Nilai yang valid: Kubernetes: kluster Kubernetes dedicated. ManagedKubernetes: kluster managed standar (kluster edge). Ask: kluster Kubernetes tanpa server (ASK).	ManagedKubernetes
ClusterName	string	Nama kluster.	test
PodIp	string	Alamat IP pod.	172.114.XX.XX
VulCount	integer	Jumlah kerentanan yang terdeteksi untuk pod, aplikasi, namespace, atau kluster saat ini.	1
AlarmCount	integer	Jumlah peringatan yang terdeteksi untuk pod, aplikasi, namespace, atau kluster saat ini.	1
RiskInstanceCount	integer	Jumlah instans yang berisiko.	1
ClusterId	string	ID kluster.	cf3824769c85441b4bf3****
Image	string	Gambar kontainer.	registry-vpc.ap-southeast-5.aliyuncs.com/log-service-release/sls-connector:1.1.77
ImageRepoNamespace	string	Namespace repository image.	name001
ImageRepoName	string	Nama repository image.	test-003
ImageRepoTag	string	Tag yang ditambahkan ke repository image.	dev-20220512-2
ImageDigest	string	Nilai digest gambar.	58e58c013f70bbfde140c8a55c1078074b3483479428d4069aa946827fd566cf
ImageUuid	string	UUID gambar.	e4bdec1d9ba7e0967111a7ea467c****
HcCount	integer	Jumlah risiko dasar yang terdeteksi untuk pod, aplikasi, namespace, atau kluster saat ini.	20
SyncOpen	integer	Menunjukkan apakah sinkronisasi log audit kluster diaktifkan. Nilai yang valid: 0: dinonaktifkan. 1: diaktifkan.	1
SyncStatus	integer	Status sinkronisasi log audit kluster. Nilai yang valid: 0: Sinkronisasi gagal. 1: Sinkronisasi berhasil.	1

Contoh

Respons sukses

JSONformat

{
  "RequestId": "4E5BFDCF-B9DD-430D-9DA4-151BCB581C9D",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 25,
    "Count": 20
  },
  "GroupedContainerInstanceList": [
    {
      "RiskLevel": "low",
      "HostIp": "172.114.XX.XX",
      "Pod": "csi-plugin-2n****",
      "RiskStatus": "NO",
      "CreateTime": 1600076893000,
      "Namespace": "kube-system",
      "CusterState": "running",
      "InstanceId": "i-8vb9ul5xec4tua4q****",
      "RegionId": "cn-hangzhou",
      "AppName": "oss-liveness-probe",
      "InstanceCount": 9,
      "ClusterType": "ManagedKubernetes",
      "ClusterName": "test",
      "PodIp": "172.114.XX.XX",
      "VulCount": 1,
      "AlarmCount": 1,
      "RiskInstanceCount": 1,
      "ClusterId": "cf3824769c85441b4bf3****",
      "Image": "registry-vpc.ap-southeast-5.aliyuncs.com/log-service-release/sls-connector:1.1.77",
      "ImageRepoNamespace": "name001",
      "ImageRepoName": "test-003",
      "ImageRepoTag": "dev-20220512-2",
      "ImageDigest": "58e58c013f70bbfde140c8a55c1078074b3483479428d4069aa946827fd566cf",
      "ImageUuid": "e4bdec1d9ba7e0967111a7ea467c****",
      "HcCount": 20,
      "SyncOpen": 1,
      "SyncStatus": 1
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message
400	IllegalParam	Illegal param
500	ServerError	ServerError
403	NoPermission	caller has no permission

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.