Get a cloud asset summary by calling GetCloudAssetSummary - Security Center

This topic is generated by a machine translation engine without any human intervention. ALIBABA CLOUD DOES NOT GUARANTEE THE ACCURACY OF MACHINE TRANSLATED CONTENT. To request a human-translated version of this topic or provide feedback on this translation, please include it in the feedback form.

Get Cloud Asset Summary

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
Vendors	array	No	List of cloud vendors to be queried.
	integer	No	Server vendor. Values: 0: Alibaba Cloud Asset 1: Non-cloud Asset 2: IDC Asset 3, 4, 5, 7: Other Cloud Assets 8: Lightweight Asset	0
CloudAssetTypes	array<object>	No	List of asset type information for cloud assets
	object	No	List of cloud asset types.
Vendor	integer	No	Server vendor. Values: 0: Alibaba Cloud Asset 1: Non-cloud Asset 2: IDC Asset 3, 4, 5, 7: Other Cloud Assets 8: Lightweight Asset	0
AssetType	integer	No	The type of asset. Values: 0: Elastic Compute Service (ECS) 1: Load Balancer 3: ApsaraDB for RDS 4: ApsaraDB for MongoDB 5: ApsaraDB for Tair (Redis compatible) 6: Container Registry 8: Container Service for Kubernetes 9: Virtual Private Cloud (VPC) 11: ActionTrail 12: Content Delivery Network (CDN) 13: SSL Certificates (now known as Certificate Management Service) 14: DevOps 16: DDoS Protection 17: Web Application Firewall 18: Object Storage Service (OSS) 19: PolarDB 20: ApsaraDB for PostgreSQL 21: Microservices Engine 22: File Storage NAS 23: Data Security Center 24: Elastic IP Address 25: Cloud Identity Service - EIAM 26: PolarDB-X 27: Elasticsearch	4
AssetSubType	integer	No	Subtypes of cloud products. Asset type-subtype. Values: 0: ECS (Elastic Compute Service) 1: Disk (Storage) 2: Security Group 100: Instance 1: Load Balancer 0: Load Balancer 1: Application Load Balancer 3: ApsaraDB RDS 0: Instance 4: ApsaraDB for MongoDB 0: Instance 5: ApsaraDB Tair (Redis Compatible) 0: Instance 6: Container Registry 1: Enterprise Edition 2: Personal Edition 8: Container Service for Kubernetes 0: Cluster 9: Virtual Private Cloud (VPC) 0: NAT Gateway 1: EIP (Elastic IP) 2: VPN 3: FLOW_LOG 11: ActionTrail 0: Trail 12: CDN 0: Instance 13: Digital Certificate Management Service (formerly SSL Certificates) 0: Certificate 14: DevOps 0: Organization 16: DDoS Protection 0: Instance 17: Web Application Firewall 0: Domain 18: Object Storage 0: Bucket 19: PolarDB (Cloud-Native Relational Database) 0: Cluster 20: ApsaraDB for PostgreSQL 0: Instance 21: Microservices Engine 0: Cluster 22: File Storage NAS 0: File System 23: Data Security Center 0: Instance 24: Elastic Public IP 0: Anycast Elastic Public IP 25: Cloud Identity Service - EIAM 0: Instance 26: PolarDB-X 0: Instance 27: Elasticsearch 0: Instance	0

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The ID of this call request, a unique identifier generated by Alibaba Cloud for the request, which can be used to troubleshoot and pinpoint issues.	F5CF78A7-30AA-59DB-847F-13EE3AE7****
GroupedFields	object	Summary information of cloud assets.
CloudAssetSummaryMetas	array<object>	List of cloud product statistics
CloudAssetSummaryMetas	object	Statistical information of cloud products
AssetType	integer	The type of cloud product. Values: 0: Elastic Compute Service (ECS) 1: Load Balancer 3: ApsaraDB for RDS 4: ApsaraDB for MongoDB 5: ApsaraDB for Tair (compatible with Redis) 6: Container Registry 8: Container Service for Kubernetes 9: Virtual Private Cloud (VPC) 11: ActionTrail 12: Content Delivery Network (CDN) 13: SSL Certificates (now known as Certificate Management Service) 14: DevOps 15: Access Control 16: DDoS Protection 17: Web Application Firewall 18: Object Storage Service (OSS) 19: PolarDB 20: ApsaraDB for PostgreSQL 21: Microservices Engine 22: NAS File Storage 23: Data Security Center 24: Elastic IP Address 25: Cloud Identity Service - EIAM 26: PolarDB-X 27: Elasticsearch	16
AssetSubType	integer	Subtype of the cloud product	0
InstanceCount	integer	Total number of this type of cloud product instances.	16
InstanceRiskCount	integer	Total number of risky instances for this type of cloud product.	5
Vendor	integer	Server vendor. Values: 0: Alibaba Cloud Asset 1: Non-cloud Asset 2: IDC Asset 3, 4, 5, 7: Other Cloud Assets 8: Lightweight Asset	3
InstanceCountTotal	integer	Total number of cloud product instances.	919
InstanceRiskCountTotal	integer	Total number of cloud product instances at risk	544

Examples

Sample success responses

JSONformat

{
  "RequestId": "F5CF78A7-30AA-59DB-847F-13EE3AE7****",
  "GroupedFields": {
    "CloudAssetSummaryMetas": [
      {
        "AssetType": 16,
        "AssetSubType": 0,
        "InstanceCount": 16,
        "InstanceRiskCount": 5,
        "Vendor": 3
      }
    ],
    "InstanceCountTotal": 919,
    "InstanceRiskCountTotal": 544
  }
}

Error codes

HTTP status code	Error code	Error message	Description
400	NoPermission	no permission	-
403	NoPermission	caller has no permission	You are not authorized to do this operation.
500	ServerError	ServerError	-

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation
2023-12-21	API Description Update. The Error code has changed. The request parameters of the API has changed	View Change Details
2023-09-20	The Error code has changed. The response structure of the API has changed	View Change Details