Gunakan GetCloudAssetCriteria untuk kueri kondisi filter pencarian aset cloud - Security Center

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

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Value	string	No	Kata kunci untuk pencarian fuzzy saat Anda melakukan kueri terhadap aset.	testwww
CloudAssetTypes	array<object>	No	Jenis aset cloud.
	object	No	Jenis aset cloud.
AssetType	integer	No	Jenis aset. Nilai yang valid: 0: Elastic Compute Service (ECS) 1: Server Load Balancer (SLB) 3: ApsaraDB RDS 4: ApsaraDB for MongoDB (MongoDB) 5: ApsaraDB for Redis (Redis) 6: Container Registry 8: Container Service for Kubernetes (ACK) 9: Virtual Private Cloud (VPC) 11: ActionTrail 12: Alibaba Cloud CDN (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: IDaaS EIAM 26: PolarDB-X 27: Elasticsearch	9
AssetSubType	integer	No	Subjenis layanan atau aset cloud. Nilai yang valid: 0: ECS 0: instance 1: disk (storage) 2: security group 1: SLB 0: SLB 1: Application Load Balancer (ALB) 3: ApsaraDB RDS 0: instance 4: MongoDB 0: instance 5: Redis 0: instance 6: Container Registry 1: Enterprise Edition 2: Personal Edition 8: ACK 0: cluster 9: VPC 0: NAT gateway 1: Elastic IP address (EIP) 2: VPN 3: VPC Flow Logs 11: ActionTrail 0: trail 12: CDN 0: instance 13: Certificate Management Service (sebelumnya SSL Certificates Service) 0: certificate 14: Apsara Devops 0: organization 16: Anti-DDoS 0: instance 17: WAF 0: domain name 18: OSS 0: bucket 19: PolarDB 0: cluster 20: ApsaraDB RDS for PostgreSQL 0: instance 21: MSE 0: cluster 22: NAS 0: file system 23: DSC 0: instance 24: EIP 0: Anycast EIP 25: IDaaS EIAM 0: instance 26: PolarDB-X 0: instance 27: Elasticsearch 0: instance	2

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan, yang digunakan untuk melokalisasi dan memecahkan masalah.	24A20733-10A0-4AF6-BE6B-E3322413BB68
CriteriaList	array<object>	Array yang berisi informasi mengenai kondisi filter yang digunakan untuk mencari aset cloud.
	object	Informasi mengenai kondisi filter yang digunakan untuk mencari aset cloud.
Type	string	Jenis kondisi filter. Nilai yang valid: input: Kondisi filter perlu ditentukan. select: Kondisi filter merupakan opsi yang dapat dipilih dari daftar drop-down.	select
Name	string	Nama kondisi filter. Nilai yang valid: instanceId: ID instans instanceName: nama instans internetIp: Alamat IP publik riskStatus: status risiko vendorRegionId: ID wilayah menurut penyedia layanan	instanceId
Values	string	Nilai kondisi pencarian. Parameter ini hanya dikembalikan jika nilai Type adalah select. Catatan Jika nilai Type adalah input, nilai parameter ini adalah string kosong.	fvt*
MultiValues	string	Nilai atribut terstruktur dari aset yang sesuai dengan kata kunci. Nilai parameter ini dalam format JSON dan berisi bidang-bidang berikut: vendor: penyedia regionIds: ID wilayah yang didukung	[{"vendor":0,"regionIds":{"default":["ap-southeast-1","ap-northeast-2","ap-southeast-3","ap-southeast-5","ap-southeast-7","me-central-1"]}},{"vendor":1,"regionIds":{"default":["outside-of-aliyun"]}}]

Contoh

Respons sukses

JSONformat

{
  "RequestId": "24A20733-10A0-4AF6-BE6B-E3322413BB68",
  "CriteriaList": [
    {
      "Type": "select",
      "Name": "instanceId",
      "Values": "fvt*",
      "MultiValues": "[{\"vendor\":0,\"regionIds\":{\"default\":[\"ap-southeast-1\",\"ap-northeast-2\",\"ap-southeast-3\",\"ap-southeast-5\",\"ap-southeast-7\",\"me-central-1\"]}},{\"vendor\":1,\"regionIds\":{\"default\":[\"outside-of-aliyun\"]}}]"
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message
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.