DescribeEnsResourceUsage - 查询资源用量_边缘节点服务 ENS(ENS)-阿里云帮助中心

调用DescribeEnsResourceUsage进行ENS查询虚机、磁盘、网络用量汇总。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
ens:DescribeEnsResourceUsage		acs:ens::{#accountId}:*	无	无

请求参数

名称	类型	必填	描述	示例值
ExpiredStartTime	string	否	vm 实例使用结束时间查询开始范围，格式： yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。	2018-06-15T09:07:23Z
ExpiredEndTime	string	否	vm 实例使用结束时间查询结束范围，格式： yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。	2018-06-15T09:07:23Z

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 请求ID。
EnsResourceUsage	object []	资源使用量数据。
ServiceType	string	服务类型： 1：预付费实例。 2：边缘服务实例。 3：后付费实例。	1
InstanceCount	integer	实例数量。	2
CpuSum	long	cpu 使用量，单位：核。	2
GpuSum	long	gpu 卡个数。	6
DownCount	integer	关机的虚机实例数。	7
ExpiredCount	integer	过期的虚机实例数。	1
ExpiringCount	integer	即将过期的虚机实例数。	0
RunningCount	integer	运行中实例的数量。	19
DiskCount	integer	数据盘数量。	4
StorageSum	long	磁盘存储总量。	5000
ComputeResourceCount	integer	边缘服务数量，只有 ServiceType=2 的时候有数据。	2

示例

正常返回示例

JSON格式

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

错误码

HTTP status code	错误码	错误信息	描述
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.	-

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作

暂无变更历史