- 最新动态
- 功能总览
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- API参考
- SDK参考
- 场景代码示例
-
常见问题
-
主机监控
- 如何配置DNS和安全组?
- 如何配置委托?
- CES Agent如何通过授权获取临时AK/SK?
- Agent支持的系统有哪些?
- Agent插件资源占用和熔断说明
- 主机监控Agent对主机的性能会有影响吗?
- Agent不同插件状态说明及处理方式
- Agent支持的指标列表
- 支持GPU监控的环境约束
- BMS硬件监控指标采集说明
- 什么是插件修复配置?
- 怎样让新购ECS实例中带有操作系统监控功能?
- Agent各种状态说明及异常状态处理方法
- 基础监控与操作系统监控数据出现不一致的问题
- 云监控服务统计的弹性云服务器网络流量与云主机系统内工具检测不一致的问题
- 未安装UVP VMTools对弹性云服务器监控指标有什么影响?
- 为什么云服务器看不到内存使用率、磁盘使用率、带内网络流入速率和带内网络流出速率四个监控指标?
- 操作系统监控GPU页面显示无记录该如何处理?
- 执行命令安装Agent报错该如何处理?
- 云服务监控
- 告警
- 站点监控
- 网络性能监控
-
主机监控
- 故障排除
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
查询所有资源分组
功能介绍
查询所创建的所有资源分组。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /V1.0/{project_id}/resource-groups
- 参数说明
表1 参数说明 名称
类型
是否必选
说明
project_id
String
是
项目ID。
获取方式请参见获取项目ID。
group_name
String
否
资源分组的名称,如:Resource-Group-ECS-01。
group_id
String
否
资源分组的ID,如:rg1603786526428bWbVmk4rP。
status
String
否
资源健康状态,值可为health、unhealth、no_alarm_rule,health表示健康。
start
Integer
否
分页起始值,类型为integer,默认值为0。
limit
Integer
否
单次查询的条数限制。取值范围(0,100],默认值为100,用于限制结果数据条数。
- 样例:查询所有资源分组。
GET https://{云监控的endpoint}/V1.0/{project_id}/resource-groups
请求消息
无
响应消息
- 响应参数
表2 响应参数 名称
参数类型
是否必选
说明
resource_groups
Array of objects
否
一个或者多个资源分组信息。
详细参数说明请参见表3。
meta_data
MetaData object
否
查询结果元数据统计个数。
详细参数说明请参见表5。
表3 resource_groups字段数据结构说明 名称
参数类型
是否必选
说明
group_name
String
否
资源分组的名称,如:ResourceGroup-Test01。
group_id
String
否
资源分组的ID,如:rg1603786526428bWbVmk4rP。
create_time
Long
否
资源分组的创建时间,UNIX时间戳,单位毫秒。如:1603819753000。
relation_ids
Array of Strings
否
企业项目ID列表。
type
String
否
资源分组添加资源方式,EPS:同步企业项目,TAG:标签动态匹配,空值:手动添加;
最小长度:0
最大长度:32
resources
Arrays of Resource objects
否
一组或者多个资源信息,默认为空。
数组长度:0 - 20
instance_statistics
InstanceStatistics object
否
资源分组中的资源信息统计。
详细参数说明请参见表4。
status
String
否
资源分组的当前状态。值可为health、unhealth、no_alarm_rule。health表示健康,unhealth表示不健康,no_alarm_rule表示未设置告警规则。
enterprise_project_id
String
否
创建资源分组时关联的企业项目。默认值为0,表示企业项目为default。
表4 instance_statistics字段数据结构说明 名称
参数类型
是否必选
说明
unhealth
Integer
否
该资源分组中当前处在告警状态的资源个数。
total
Integer
否
该资源分组中资源的总个数。
type_statistics
Integer
否
该资源分组中选择的资源类型个数。如资源分组添加了弹性云服务、弹性公网IP和带宽则值为2。
- 返回样例
{ "resource_groups": [ { "group_name": "ResourceGroup-Test01", "create_time": 1606374365000, "group_id": "rg16063743652226ew93e64p", "relation_ids": ["0"], "instance_statistics": { "unhealth": 2, "total": 10, "type_statistics": 1 }, "status": "unhealth", "enterprise_project_id": "0", "type": "TAG", "resources": [] }, { "group_name": "RS", "create_time": 1606327955000, "group_id": "rg1606327955657LRj1lrE4y", "relation_ids": ["0"], "instance_statistics": { "unhealth": 0, "total": 2, "type_statistics": 1 }, "status": "no_alarm_rule", "enterprise_project_id": "0", "type": "TAG", "resources": [] }, { "group_name": "RS", "create_time": 1606327947000, "group_id": "rg1606327947514v9OWqAD3N", "relation_ids": ["0"], "instance_statistics": { "unhealth": 0, "total": 2, "type_statistics": 1 }, "status": "no_alarm_rule", "enterprise_project_id": "0", "type": "TAG", "resources": [] }, { "group_name": "RS", "create_time": 1606327946000, "group_id": "rg1606327946625PYogr059N", "relation_ids": ["0"], "instance_statistics": { "unhealth": 0, "total": 2, "type_statistics": 1 }, "status": "no_alarm_rule", "enterprise_project_id": "0", "type": "TAG", "resources": [] }, { "group_name": "ResourceGroupCorrect_2", "create_time": 1606325669000, "group_id": "rg1606325669900Rk4eKkLMZ", "relation_ids": ["0"], "instance_statistics": { "unhealth": 0, "total": 1, "type_statistics": 1 }, "status": "no_alarm_rule", "enterprise_project_id": "0", "type": "TAG", "resources": [] } ], "meta_data": { "total": 5 } }
- 返回样例
返回值
错误码
请参考返回错误码说明。