DescribeEnsResourceUsage - ENS - Alibaba Cloud Documentation Center

Queries the usage summary of ENS virtual machines (VMs), disks, and networks.

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
ExpiredStartTime	string	No	The beginning of the time range to query. Format: yyyy-MM-dd or yyyy-MM-dd HH:mm:ss.	2018-06-15T09:07:23Z
ExpiredEndTime	string	No	The end of the time range to query. Format: yyyy-MM-dd or yyyy-MM-dd HH:mm:ss.	2018-06-15T09:07:23Z

Response parameters

Parameter	Type	Description	Example
	object	Schema of Response
RequestId	string	The request ID.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E Request ID.
EnsResourceUsage	array<object>	The resource usage data.
ensResourceUsage	object	Resource usage data.
ServiceType	string	The type of the service. Valid values: 1: subscription instance. 2: edge service instance. 3: pay-as-you-go instance.	1
InstanceCount	integer	The number of instances.	2
CpuSum	long	The CPU usage. Unit: cores.	2
GpuSum	long	The number of GPUs.	6
DownCount	integer	The number of stopped VMs.	7
ExpiredCount	integer	The number of expired VM instances.	1
ExpiringCount	integer	The number of VM instances that are about to expire.	0
RunningCount	integer	The number of running instances.	19
DiskCount	integer	The number of data disks.	4
StorageSum	long	The total disk size.	5000
ComputeResourceCount	integer	The number of edge services. This parameter is available only when you set the ServiceType parameter to 2.	2

Examples

Sample success responses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E\t Request ID.",
  "EnsResourceUsage": [
    {
      "ServiceType": 1,
      "InstanceCount": 2,
      "CpuSum": 2,
      "GpuSum": 6,
      "DownCount": 7,
      "ExpiredCount": 1,
      "ExpiringCount": 0,
      "RunningCount": 19,
      "DiskCount": 4,
      "StorageSum": 5000,
      "ComputeResourceCount": 2
    }
  ]
}

Error codes

HTTP status code	Error code	Error message
400	ens.interface.error	An error occurred while call the API.
400	Invalid%s	The specified parameter %s is invalid.
400	Missing%s	You must specify the parameter %s.
400	NoPermission	Permission denied.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.

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

Change history

Change time	Summary of changes	Operation

No change history