全部产品
Search

搜索本产品

    边缘节点服务ENS：DescribeEnsResourceUsage - 查询资源用量

    文档中心

    边缘节点服务ENS：DescribeEnsResourceUsage - 查询资源用量

    更新时间：Aug 27, 2026

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

    调试

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

    调试

    授权信息

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

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ens:DescribeEnsResourceUsage

    get

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    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

    array<object>

    资源使用量数据。

    object

    资源使用量数据。

    ServiceType

    string

    服务类型：

    • 1：预付费实例。

    • 2：边缘服务实例。

    • 3：后付费实例。

    1
    InstanceCount

    integer

    实例数量。

    2
    CpuSum

    integer

    cpu 使用量，单位：核。

    2
    GpuSum

    integer

    gpu 卡个数。

    6
    DownCount

    integer

    关机的虚机实例数。

    7
    ExpiredCount

    integer

    过期的虚机实例数。

    1
    ExpiringCount

    integer

    即将过期的虚机实例数。

    0
    RunningCount

    integer

    运行中实例的数量。

    19
    DiskCount

    integer

    数据盘数量。

    4
    StorageSum

    integer

    磁盘存储总量。

    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.

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

    变更历史

    更多信息，参考变更详情。