获取实例监控信息 - ShowStatusInstance

功能介绍

CPCS服务创建的密码服务实例的状态监控

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
cpcs::getStatusInstance
Read
-
-
cpcs:system:getStatusInstance
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
cpcs::getStatusInstance	Read	-	-	cpcs:system:getStatusInstance	-

URI

GET /v1/{project_id}/dew/cpcs/instance/status

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目id

表2 Query参数
参数	是否必选	参数类型	描述
cluster_id	否	String	集群ID，默认空字符串，默认查询所有集群。
app_id	否	String	应用ID，默认空字符串，默认查询所有应用。
instance_id	否	String	集群ID，默认空字符串，默认查询所有集群。
from	否	Long	查询范围起始时间，毫秒时间戳，默认为0，默认查询三天前。
to	否	Long	查询范围终止时间，毫秒时间戳，默认为0，默认查询到当前时间。
period	否	Integer	数据统计周期，默认0，默认为5分钟。
filter	否	String	统计类型，默认min，默认用统计周期中数据的最小值。
server_type	否	String	服务类型，默认空字符串，默认查询所有服务类型。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	iam鉴权token

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
cpu_utils	Array of ShowStatusInstanceItem objects	CPU使用率
mem_utils	Array of ShowStatusInstanceItem objects	内存使用率
disk_utils	Array of ShowStatusInstanceItem objects	磁盘使用率
cpu_util_instance_names	Array of strings	CPU使用率对应实例名称
mem_util_instance_names	Array of strings	内存使用率对应实例名称
disk_util_instance_names	Array of strings	磁盘使用率对应实例名称
cpu_util_averages	Array of doubles	CPU使用率平均值
mem_util_averages	Array of doubles	内存使用率平均值
disk_util_averages	Array of doubles	磁盘使用率平均值

表5 ShowStatusInstanceItem
参数	参数类型	描述
instance_list	Array of instance_list objects	实例列表
timestamp	Integer	采集时间，UNIX时间戳，单位毫秒

表6 instance_list
参数	参数类型	描述
instance_name	String	实例名称
value	Integer	采集值

请求示例

实例状态监控

GET https://cpcs.com/v1/{project_id}/dew/cpcs/instance/status?from=1736933523900&to=1737019923900&period=3600&metric_name="cpu_util"&instance_id=

空数据时的情况

GET https://cpcs.com/v1/{project_id}/dew/cpcs/instance/status?from=1736933523900&to=1737019923900&period=3600&metric_name="cpu_util"&instance_id=

响应示例

状态码：200

正常返回

{
  "disk_util_instance_names" : [ "dsfdsaaaaaa-0", "test_crypto-0" ],
  "mem_util_averages" : [ 31.987796610169507, 0 ],
  "mem_util_instance_names" : [ "dsfdsaaaaaa-0", "test_crypto-0" ],
  "cpu_util_averages" : [ 4.03, 0 ],
  "mem_utils" : [ {
    "instance_list" : [ {
      "instance_name" : "test_crypto-0",
      "value" : 0
    }, {
      "instance_name" : "dsfdsaaaaaa-0",
      "value" : 30.2
    } ],
    "timestamp" : 1757416860002
  }, {
    "instance_list" : [ {
      "instance_name" : "test_crypto-0",
      "value" : 0
    }, {
      "instance_name" : "dsfdsaaaaaa-0",
      "value" : 30.3
    } ],
    "timestamp" : 1757416920002
  } ],
  "cpu_util_instance_names" : [ "dsfdsaaaaaa-0", "test_crypto-0" ],
  "disk_util_averages" : [ 7.627288135593223, 0 ],
  "cpu_utils" : [ {
    "instance_list" : [ {
      "instance_name" : "test_crypto-0",
      "value" : 0
    }, {
      "instance_name" : "dsfdsaaaaaa-0",
      "value" : 3.51
    } ],
    "timestamp" : 1757416860002
  }, {
    "instance_list" : [ {
      "instance_name" : "test_crypto-0",
      "value" : 0
    }, {
      "instance_name" : "dsfdsaaaaaa-0",
      "value" : 3.26
    } ],
    "timestamp" : 1757416920002
  } ],
  "disk_utils" : [ {
    "instance_list" : [ {
      "instance_name" : "test_crypto-0",
      "value" : 0
    }, {
      "instance_name" : "dsfdsaaaaaa-0",
      "value" : 7.62
    } ],
    "timestamp" : 1757416860002
  }, {
    "instance_list" : [ {
      "instance_name" : "test_crypto-0",
      "value" : 0
    }, {
      "instance_name" : "dsfdsaaaaaa-0",
      "value" : 7.62
    } ],
    "timestamp" : 1757416920002
  } ]
}