检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API API版本号 云资源监控 资源配额 事件监控 告警 资源分组
API概览 通过使用云监控所提供的接口，您可以完整的使用云监控的所有功能。例如查询指标列表、创建告警规则等。 表1 接口说明 类型 子类型 API 说明 API V1 API版本号管理 查询API所有版本 查询云监控支持的API所有版本号。 查询API指定版本号 查询云监控API指定版本号。
事件监控接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 上报自定义事件。 POST /V1.0/{project_id}/events ces:events:post √ × 父主题： 权限和授权项
Agent任务相关接口 Agent任务相关接口 查询Agent任务列表 批量创建Agent任务 父主题： 云资源监控
API版本号管理接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 查询云监控支持的API所有版本号。 GET / ces:versions:get √ × 查询云监控API指定版本号。 GET /{api_version} ces:versions:get √ ×
API 批量查询监控数据 查询监控数据 父主题： 故障排查
即响应参数metrics属性对应对象datapoints属性累加最多返回3000个数据点）。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /V1.0/{
如何调用API 构造请求 认证鉴权 返回结果
批量创建Agent任务 功能介绍 批量创建Agent任务 接口约束 目前拉美-布宜诺斯艾利斯一、拉美-利马一2个局点不支持该接口 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
查询Agent任务列表 功能介绍 查询Agent任务列表 接口约束 目前拉美-布宜诺斯艾利斯一、拉美-利马一2个局点不支持该接口 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
指标管理接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 查询系统当前可监控指标列表，可以指定指标命名空间、指标名称、维度、排序方式，起始记录和最大记录条数过滤查询结果。 GET /V1.0/{project_id}/metrics ces:metrics:list
查询API所有版本 功能介绍 查询云监控支持的API所有版本号。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET / 请求消息 请求样例 GET https://{云监控的终端节点}/
配额管理接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 查询用户可以创建的资源配额总数及当前使用量，当前仅有告警规则一种资源类型。 GET /V1.0/{project_id}/quotas ces:quotas:get √ × 父主题： 权限和授权项
API版本号 API版本号管理 父主题： API
告警规则管理接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 查询告警规则列表，可以指定分页条件限制结果数量，可以指定排序规则。 GET /V1.0/{project_id}/alarms ces:alarms:list √ √ 根据告警ID查询告警规则信息。 GET
监控数据管理接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 查询指定时间范围指定指标的指定粒度的监控数据，可以通过参数指定需要查询的数据维度。 GET /V1.0/{project_id}/metric-data?namespace={namespace}&m
API版本号管理 查询API所有版本 查询API指定版本号 父主题： API版本号
查询API指定版本号 功能介绍 查询云监控API指定版本号。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /{api_version} 参数说明 表1 参数说明
告警规则管理 查询告警规则列表（V1） 查询告警规则列表（推荐） 查询单条告警规则信息 启停告警规则 批量启停告警规则 删除告警规则 批量删除告警规则 创建告警规则（V1） 创建告警规则（推荐） 创建自定义告警模板 删除自定义告警模板 查询告警历史 查询自定义告警模板列表 更新自定义告警模板
快速入门 概述 本节通过调用一系列云监控的API为ECS的cpu_util指标创建告警规则，当指标的数值达到设置的阈值时及时通知用户处理。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。 操作步骤 Token认证，具体操作请参考认证鉴权。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
