DescribeEnsResourceUsage - 查询资源用量

更新时间:
复制为 MD 格式

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

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ExpiredStartTimestring

vm 实例使用结束时间查询开始范围,格式: yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。

2018-06-15T09:07:23Z
ExpiredEndTimestring

vm 实例使用结束时间查询结束范围,格式: yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。

2018-06-15T09:07:23Z

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E 请求ID。
EnsResourceUsagearray<object>

资源使用量数据。

ensResourceUsageobject

资源使用量数据。

ServiceTypestring

服务类型:

  • 1:预付费实例。
  • 2:边缘服务实例。
  • 3:后付费实例。
1
InstanceCountinteger

实例数量。

2
CpuSumlong

cpu 使用量,单位:核。

2
GpuSumlong

gpu 卡个数。

6
DownCountinteger

关机的虚机实例数。

7
ExpiredCountinteger

过期的虚机实例数。

1
ExpiringCountinteger

即将过期的虚机实例数。

0
RunningCountinteger

运行中实例的数量。

19
DiskCountinteger

数据盘数量。

4
StorageSumlong

磁盘存储总量。

5000
ComputeResourceCountinteger

边缘服务数量,只有 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错误码错误信息描述
400ens.interface.errorAn error occurred while call the API.-
400Invalid%sThe specified parameter %s is invalid.参数不正确
400Missing%sYou must specify the parameter %s.参数为必填
400NoPermissionPermission denied.没有足够的权限,请联系云账号管理员授予您相应权限。
400InvalidParameter.%sThe specified field %s invalid. Please check it again.-

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

变更历史

变更时间变更内容概要操作
暂无变更历史