Get a cloud asset summary by calling GetCloudAssetSummary - Security Center - Alibaba Cloud - Security Center

Retrieves the summary of cloud assets.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
Vendors	array	No	The list of cloud vendors to query.
	integer	No	The server vendor. Valid values: 0: Alibaba Cloud asset 1: non-cloud asset 2: IDC asset 3, 4, 5, 7: third-party cloud asset 8: lightweight asset	0
CloudAssetTypes	array<object>	No	The list of asset type information for cloud assets.
	object	No	The list of asset type information for cloud assets.
Vendor	integer	No	The server vendor. Valid values: 0: Alibaba Cloud asset 1: non-cloud asset 2: IDC asset 3, 4, 5, 7: third-party cloud asset 8: lightweight asset	0
AssetType	integer	No	The type of the asset. Valid values: 0: Elastic Compute Service (ECS) server 1: load balancing 3: ApsaraDB RDS database 4: ApsaraDB for MongoDB database 5: Tair (Redis® OSS-Compatible) database 6: Container Registry 8: Container Service for Kubernetes (ACK) 9: Virtual Private Cloud (VPC) 11: ActionTrail 12: CDN 13: Certificate Management Service (formerly SSL Certificates Service) 14: Apsara Devops 16: Anti-DDoS 17: Web Application Firewall (WAF) 18: Object Storage Service (OSS) 19: cloud-native relational database PolarDB 20: ApsaraDB RDS for PostgreSQL database 21: Microservices Engine (MSE) 22: Apsara File Storage NAS 23: Data Security Center (DSC) 24: Elastic IP Address (EIP) 25: Alibaba Cloud IDaaS EIAM 26: PolarDB-X 27: Elasticsearch	4
AssetSubType	integer	No	The subtype of the cloud service. The value is in the format of asset type - subtype. Valid values: 0: Elastic Compute Service (ECS) server 1: cloud disk (storage) 2: security group 100: instance 1: load balancing 0: load balancing 1: Application Load Balancer (ALB) 3: ApsaraDB RDS database 0: instance 4: ApsaraDB for MongoDB database 0: instance 5: Tair (Redis® OSS-Compatible) database 0: instance 6: Container Registry 1: Enterprise Edition 2: Personal Edition 8: Container Service for Kubernetes (ACK) 0: cluster 9: Virtual Private Cloud (VPC) 0: NAT gateway 1: EIP 2: VPN 3: FLOW_LOG 11: ActionTrail 0: trail 12: CDN 0: instance 13: Certificate Management Service (formerly SSL Certificates Service) 0: certificate 14: Apsara Devops 0: organization 16: Anti-DDoS 0: instance 17: Web Application Firewall (WAF) 0: domain name 18: Object Storage Service (OSS) 0: Bucket 19: cloud-native relational database PolarDB 0: cluster 20: ApsaraDB RDS for PostgreSQL database 0: instance 21: Microservices Engine (MSE) 0: cluster 22: Apsara File Storage NAS 0: file system 23: Data Security Center (DSC) 0: instance 24: Elastic IP Address (EIP) 0: Anycast EIP 25: Alibaba Cloud IDaaS EIAM 0: instance 26: PolarDB-X 0: instance 27: Elasticsearch 0: instance	0
IsSaleData	boolean	No	Specifies whether to return sale-related data. Valid values: true: Returns sale-related data. false: Does not return sale-related data.	true

Response elements

Element	Type	Description	Example
	object
RequestId	string	The ID of the request. Alibaba Cloud generates a unique identifier for each request. You can use the request ID to troubleshoot issues.	F5CF78A7-30AA-59DB-847F-13EE3AE7****
GroupedFields	object	The cloud asset summary information.
CloudAssetSummaryMetas	array<object>	The list of cloud service statistics information.
	object	The statistics information of the cloud service.
AssetType	integer	The type of the cloud service. Valid values: 0: Elastic Compute Service (ECS) server 1: Load balancing 3: ApsaraDB RDS database 4: ApsaraDB for MongoDB database 5: Tair (Redis® OSS-Compatible) database 6: Container Registry 8: Container Service for Kubernetes (ACK) 9: Virtual Private Cloud (VPC) 11: ActionTrail 12: CDN 13: Certificate Management Service (formerly SSL Certificates Service) 14: Apsara Devops 15: Resource Access Management (RAM) 16: Anti-DDoS 17: Web Application Firewall (WAF) 18: Object Storage Service (OSS) 19: Cloud-native relational database PolarDB 20: ApsaraDB RDS for PostgreSQL database 21: Microservices Engine (MSE) 22: Apsara File Storage NAS 23: Data Security Center (DSC) 24: Elastic IP Address (EIP) 25: Alibaba Cloud IDaaS EIAM 26: PolarDB-X 27: Elasticsearch.	16
AssetSubType	integer	The subtype of the cloud service.	0
InstanceCount	integer	The total number of instances of this cloud service type.	16
InstanceRiskCount	integer	The total number of at-risk instances of this cloud service type.	5
Vendor	integer	The server vendor. Valid values: 0: Alibaba Cloud asset 1: Non-cloud asset 2: IDC asset 3, 4, 5, 7: Other cloud asset 8: Lightweight asset.	3
InstanceSaleCount	integer		1
IsInstanceSale	boolean
InstanceCountTotal	integer	The total number of cloud service instances.	919
InstanceRiskCountTotal	integer	The total number of at-risk cloud service instances.	544
InstanceSaleCountTotal	integer	The total number of cloud services billed by instance.	10

Examples

Success response

JSON format

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

Error codes

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

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.