Panggil ListCloudAssetInstances untuk kueri aset cloud - Security Center

Mengambil daftar aset layanan cloud.

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

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah instans.	cn-hangzhou
Criteria	string	No	Kondisi pencarian untuk aset. Nilai parameter ini dalam format JSON dan berisi bidang-bidang berikut: name: nama kondisi pencarian. value: nilai kondisi pencarian. logicalExp: relasi logis untuk beberapa kondisi pencarian. Nilai yang valid: OR: Kondisi pencarian menggunakan logika OR. AND: Kondisi pencarian menggunakan logika AND. Catatan Anda dapat memanggil operasi GetCloudAssetCriteria untuk menanyakan kondisi pencarian yang didukung.	[{\"name\":\"internetIp\",\"value\":\"192.168\",\"logicalExp\":\"OR\"}]
LogicalExp	string	No	Relasi logis untuk beberapa kondisi pencarian. Nilai yang valid: OR: Kondisi pencarian menggunakan logika OR. AND: Kondisi pencarian menggunakan logika AND.	OR
PageSize	integer	No	Jumlah entri yang dikembalikan per halaman. Nilai maksimum: 100. Nilai default: 20.	20
CurrentPage	integer	No	Nomor halaman yang akan dikembalikan.	2
CloudAssetTypes	array<object>	No	Detail aset cloud.
	object	No	Aset layanan cloud.
AssetType	integer	No	Tipe aset cloud. Anda dapat memanggil operasi GetCloudAssetCriteria untuk menanyakan tipe aset cloud.	18
AssetSubType	integer	No	Subtipe aset cloud. Anda dapat memanggil operasi GetCloudAssetCriteria untuk menanyakan subtipe aset cloud.	0
Vendor	integer	No	Tipe server. Nilai yang valid: 0: aset cloud yang disediakan oleh Alibaba Cloud 1: aset cloud di luar Alibaba Cloud 2: aset cloud di data center 3, 4, 5, dan 7: aset cloud yang disediakan oleh penyedia layanan pihak ketiga 8: aset cloud ringan	0
CloudAssetQueryData	array<object>	No	Daftar data kueri berdasarkan kata kunci.
	object	No
Data	string	No	Konten kueri.	163.8.8.9
Operator	string	No	Operator kueri, saat ini hanya mendukung: INCLUDE.	INCLUDE

Elemen respons

Element	Type	Description	Example
	object
Success	boolean	Menunjukkan apakah permintaan berhasil. Nilai yang valid: true: Permintaan berhasil. false: Permintaan gagal.	true
RequestId	string	ID permintaan, yang digunakan untuk melokalisasi dan memecahkan masalah.	028CF634-5268-5660-9575-48C9ED6BF880
PageInfo	object	Informasi paginasi.
CurrentPage	integer	Nomor halaman dari halaman yang dikembalikan.	2
PageSize	integer	Jumlah entri yang dikembalikan per halaman.	100
TotalCount	integer	Jumlah total aset cloud.	69
Count	integer	Jumlah entri yang dikembalikan pada halaman saat ini.	20
Instances	array<object>	Detail aset cloud.
	object	Detail aset cloud.
RegionId	string	ID wilayah tempat aset cloud berada.	cn-hanghzou
Vendor	integer	Penyedia layanan (SP) aset cloud. Nilai yang valid: 0: aset cloud yang disediakan oleh Alibaba Cloud 1: aset cloud pihak ketiga 2: aset cloud di data center 3, 4, 5, dan 7: aset cloud lainnya 8: aset cloud ringan	0
AssetType	integer	Tipe aset cloud. Nilai yang valid: 0: Elastic Compute Service (ECS) 1: Server Load Balancer (SLB) 3: ApsaraDB RDS 4: ApsaraDB for MongoDB 5: ApsaraDB for Redis 6: Container Registry 8: Container Service for Kubernetes (ACK) 9: Virtual Private Cloud (VPC) 11: ActionTrail 12: Alibaba Cloud CDN 13: Certificate Management Service (sebelumnya SSL Certificates Service) 14: Apsara Devops 16: Anti-DDoS 17: Web Application Firewall (WAF) 18: Object Storage Service (OSS) 19: PolarDB 20: ApsaraDB RDS for PostgreSQL 21: Microservices Engine (MSE) 22: File Storage NAS (NAS) 23: Data Security Center (DSC) 24: Elastic IP Address (EIP) 25: Identity as a Service (IDaaS) Employee Identity and Access Management (EIAM) 26: PolarDB-X 27: Elasticsearch	0
AssetSubType	string	Subtipe layanan cloud. Subtipe aset cloud. Nilai yang valid: 0: ECS 0: instans 1: disk (storage) 2: security group 1: SLB 0: SLB 1: Application Load Balancer (ALB) 3: ApsaraDB RDS 0: instans 4: ApsaraDB for MongoDB 0: instans 5: ApsaraDB for Redis 0: instans 6: Container Registry 1: Edisi Perusahaan 2: Edisi Personal 8: ACK 0: kluster 9: VPC 0: NAT gateway 1: EIP 2: VPN 3: FLOW_LOG 11: ActionTrail 0: trail 12: Alibaba Cloud CDN 0: instans 13: Certificate Management Service (sebelumnya SSL Certificates Service) 0: Sertifikat 14: Apsara Devops 0: organisasi 16: Anti-DDoS 0: instans 17: WAF 0: Nama domain 18: OSS 0: bucket 19: PolarDB 0: kluster 20: ApsaraDB RDS for PostgreSQL 0: instans 21: MSE 0: kluster 22: NAS 0: sistem file 23: DSC 0: instans 24: EIP 0: Anycast EIP 25: IDaaS EIAM 0: instans 26: PolarDB-X 0: instans 27: Elasticsearch 0: instans	0
InstanceId	string	ID instans aset cloud.	d-uf60vevzkztnflx7cny5
InstanceName	string	Nama instans aset cloud.	yztest-l***
CreatedTime	integer	Waktu saat instans dibuat.	1607365213000
InternetIp	string	Alamat IP publik aset cloud.	1.2.XX.XX
AlarmStatus	string	Menunjukkan apakah terdapat alert untuk aset cloud. Nilai yang valid: YES NO	NO
RiskStatus	string	Menunjukkan apakah terdapat risiko yang terdeteksi pada aset cloud. Nilai yang valid: YES NO	NO
AssetTypeName	string	Nama tipe aset cloud.	ECS
AssetSubTypeName	string	Nama subtipe aset cloud.	SECURITY_GROUP
SecurityInfo	string	Informasi keamanan mengenai aset cloud.	{"seriousNum":0,"appNum":0,"baselineMedium":0,"remindNum":0,"imageVulNntf":0,"cveNum":0,"vul":0,"uuid":"yuejia-test","emgNum":0,"weakPWNum":0,"imageMaliciousFileRemind":0,"imageBaselineMedium":0,"laterVulCount":0,"cmsNum":0,"imageMaliciousFileSerious":0,"agentlessMalicious":0,"suspNum":0,"imageBaselineHigh":0,"asapVulCount":0,"imageVulLater":0,"agentlessAll":0,"sysNum":0,"containerLater":0,"containerSuspicious":0,"imageBaselineNum":0,"newSuspicious":0,"nntfVulCount":0,"scaNum":0,"containerNntf":0,"health":0,"trojan":0,"suspicious":0,"imageMaliciousFileSuspicious":0,"containerRemind":0,"baselineLow":0,"imageVulAsap":0,"imageBaselineLow":0,"containerAsap":0,"agentlessBaseline":0,"agentlessVulSca":0,"agentlessVulCve":0,"containerSerious":0,"baselineHigh":0,"account":0,"baselineNum":5}
Tags	array	Daftar tag.
	string	Tag.	AI
VendorUid	string	ID akun instans multi-cloud.	123xxx
VendorUserName	string	Nama pengguna instans multi-cloud.	testxxx

Contoh

Respons sukses

JSONformat

{
  "Success": true,
  "RequestId": "028CF634-5268-5660-9575-48C9ED6BF880",
  "PageInfo": {
    "CurrentPage": 2,
    "PageSize": 100,
    "TotalCount": 69,
    "Count": 20
  },
  "Instances": [
    {
      "RegionId": "cn-hanghzou",
      "Vendor": 0,
      "AssetType": 0,
      "AssetSubType": "0",
      "InstanceId": "d-uf60vevzkztnflx7cny5",
      "InstanceName": "yztest-l***",
      "CreatedTime": 1607365213000,
      "InternetIp": "1.2.XX.XX",
      "AlarmStatus": "NO",
      "RiskStatus": "NO",
      "AssetTypeName": "ECS",
      "AssetSubTypeName": "SECURITY_GROUP",
      "SecurityInfo": "{\"seriousNum\":0,\"appNum\":0,\"baselineMedium\":0,\"remindNum\":0,\"imageVulNntf\":0,\"cveNum\":0,\"vul\":0,\"uuid\":\"yuejia-test\",\"emgNum\":0,\"weakPWNum\":0,\"imageMaliciousFileRemind\":0,\"imageBaselineMedium\":0,\"laterVulCount\":0,\"cmsNum\":0,\"imageMaliciousFileSerious\":0,\"agentlessMalicious\":0,\"suspNum\":0,\"imageBaselineHigh\":0,\"asapVulCount\":0,\"imageVulLater\":0,\"agentlessAll\":0,\"sysNum\":0,\"containerLater\":0,\"containerSuspicious\":0,\"imageBaselineNum\":0,\"newSuspicious\":0,\"nntfVulCount\":0,\"scaNum\":0,\"containerNntf\":0,\"health\":0,\"trojan\":0,\"suspicious\":0,\"imageMaliciousFileSuspicious\":0,\"containerRemind\":0,\"baselineLow\":0,\"imageVulAsap\":0,\"imageBaselineLow\":0,\"containerAsap\":0,\"agentlessBaseline\":0,\"agentlessVulSca\":0,\"agentlessVulCve\":0,\"containerSerious\":0,\"baselineHigh\":0,\"account\":0,\"baselineNum\":5}",
      "Tags": [
        "AI"
      ],
      "VendorUid": "123xxx",
      "VendorUserName": "testxxx"
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message
400	AccountIdNotExist	AccountId not exist
400	NoPermission	no permission
500	ServerError	ServerError
403	NoPermission	caller has no permission

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.