文档首页/ 企业主机安全 HSS/ API参考（吉隆坡区域）/ API说明/ 配额管理/ 查询配额详情
更新时间：2025-09-23 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询配额详情

功能介绍

查询配额详情

URI

GET /v5/{project_id}/billing/quotas-detail

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID
表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

否

String

企业项目ID，查询所有企业项目时填写：all_granted_eps

version

否

String

主机开通的版本，包含如下7种输入。

  • hss.version.null ：无。

  • hss.version.basic ：基础版。

  • hss.version.advanced ：专业版。

  • hss.version.enterprise ：企业版。

  • hss.version.premium ：旗舰版。

  • hss.version.wtp ：网页防篡改版。

  • hss.version.container.enterprise：容器版。

category

否

String

类别，包含如下几种：

  • host_resource ：HOST_RESOURCE

  • container_resource ：CONTAINER_RESOURCE

quota_status

否

String

配额状态，包含如下几种：

  • normal ： QUOTA_STATUS_NORMAL

  • expired ：QUOTA_STATUS_EXPIRED

  • freeze ：QUOTA_STATUS_FREEZE

used_status

否

String

使用状态，包含如下几种：

  • idle ：USED_STATUS_IDLE

  • used ：USED_STATUS_USED

host_name

否

String

服务器名称

resource_id

否

String

资源ID

charging_mode

否

String

收费模式，包含如下：

  • on_demand ：按需。

limit

否

Integer

每页数量

offset

否

Integer

偏移量：指定返回记录的开始位置，必须为数字，取值范围为大于或等于0，默认0

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

x-auth-token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

packet_cycle_num

Integer

配额数

on_demand_num

Integer

按需配额数

used_num

Integer

已使用配额数

idle_num

Integer

空闲配额数

normal_num

Integer

正常配额数

expired_num

Integer

过期配额数

freeze_num

Integer

冻结配额数

quota_statistics_list

Array of QuotaStatisticsResponseInfo objects

配额统计列表

total_num

Integer

总数

data_list

Array of QuotaResourcesResponseInfo objects

配额列表
表5 QuotaStatisticsResponseInfo

参数

参数类型

描述

version

String

资源规格编码，包含如下:

  • hss.version.basic : 基础版

  • hss.version.advanced : 专业版

  • hss.version.enterprise : 企业版

  • hss.version.premium : 旗舰版

  • hss.version.wtp : 网页防篡改版

  • hss.version.container : 容器版

total_num

Integer

总数
表6 QuotaResourcesResponseInfo

参数

参数类型

描述

resource_id

String

主机安全配额的资源ID

version

String

资源规格编码，包含如下:

  • hss.version.basic : 基础版

  • hss.version.advanced : 专业版

  • hss.version.enterprise : 企业版

  • hss.version.premium : 旗舰版

  • hss.version.wtp : 网页防篡改版

  • hss.version.container : 容器版

quota_status

String

配额状态

  • normal : 正常

  • expired : 已过期

  • freeze : 已冻结

used_status

String

使用状态

  • idle : 空闲

  • used : 使用中

host_id

String

服务器ID

host_name

String

服务器名称

charging_mode

String

计费模式

  • on_demand : 按需

tags

Array of TagInfo objects

标签

expire_time

Long

过期时间，-1表示没有到期时间

shared_quota

String

是否共享配额

  • shared：共享的

  • unshared：非共享的

enterprise_project_id

String

企业项目ID

enterprise_project_name

String

所属企业项目名称
表7 TagInfo

参数

参数类型

描述

key

String

键。最大长度128个unicode字符。 key不能为空

value

String

值。最大长度255个unicode字符。

请求示例

查询所有企业项目下的配额详情

GET https://{endpoint}/v5/{project_id}/billing/quotas-detail?offset=0&limit=100&version=hss.version.basic&enterprise_project_id=all_granted_eps

响应示例

状态码：200

配额详情列表

{
  "data_list" : [ {
    "charging_mode" : "on_demand",
    "expire_time" : -1,
    "host_id" : "71a15ecc-049f-4cca-bd28-5e90aca1817f",
    "host_name" : "zhangxiaodong2",
    "quota_status" : "normal",
    "resource_id" : "af4d08ad-2b60-4916-a5cf-8d6a23956dda",
    "shared_quota" : "shared",
    "tags" : [ {
      "key" : "服务",
      "value" : "HSS"
    } ],
    "used_status" : "used",
    "version" : "hss.version.wtp"
  } ],
  "expired_num" : 0,
  "freeze_num" : 0,
  "idle_num" : 20,
  "normal_num" : 60,
  "on_demand_num" : 0,
  "packet_cycle_num" : 60,
  "quota_statistics_list" : [ {
    "total_num" : 8,
    "version" : "hss.version.basic"
  } ],
  "total_num" : 60,
  "used_num" : 40
}

状态码

状态码

描述

200

配额详情列表

错误码

请参见错误码。

父主题： 配额管理