检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 通过使用云监控所提供的接口，您可以完整的使用云监控的所有功能。例如查询指标列表、创建告警规则等。 表1 接口说明 类型 子类型 API 说明 API V1 API版本号管理 查询API所有版本 查询云监控支持的API所有版本号。 查询API指定版本号 查询云监控API指定版本号
事件监控接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 上报自定义事件。 POST /V1.0/{project_id}/events ces:events:post √ × 父主题： 权限和授权项
监控数据管理接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 查询指定时间范围指定指标的指定粒度的监控数据，可以通过参数指定需要查询的数据维度。 GET /V1.0/{project_id}/metric-data?
API版本号管理接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 查询云监控支持的API所有版本号。 GET / ces:versions:get √ × 查询云监控API指定版本号。
指标管理接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 查询系统当前可监控指标列表，可以指定指标命名空间、指标名称、维度、排序方式，起始记录和最大记录条数过滤查询结果。
告警规则管理接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 查询告警规则列表，可以指定分页条件限制结果数量，可以指定排序规则。 GET /V1.0/{project_id}/alarms ces:alarms:list √ √ 根据告警ID查询告警规则信息。
配额管理接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 查询用户可以创建的资源配额总数及当前使用量，当前仅有告警规则一种资源类型。 GET /V1.0/{project_id}/quotas ces:quotas:get √ × 父主题： 权限和授权项
批量查询监控数据 功能介绍 批量查询指定时间范围内指定指标的指定粒度的监控数据，目前最多支持500个指标的批量查询（即请求体参数metrics属性数组长度最大500），最多返回指标数据点3000个（即响应参数metrics属性对应对象datapoints属性累加最多返回3000个数据点
如何调用API 构造请求 认证鉴权 返回结果
API API版本号 云资源监控 资源配额 事件监控 告警 资源分组
对应API接口：自定义策略实际调用的API接口。 云监控的支持自定义策略授权项如下所示： 表格中“√”表示支持，“×”表示暂不支持。
API 批量查询监控数据 查询监控数据
Agent任务相关接口 Agent任务相关接口 查询Agent任务列表 批量创建Agent任务 父主题： 云资源监控
返回错误码说明 功能说明 API调用发生错误时，会有错误结构体返回，该小节主要是对云监控封装接口错误结构的解释。 v1接口返回体示例 { "http_code":"403", "message": { "details":"Policy doesn't
同时您可以很方便使用云监控服务管理控制台或API接口查看云服务运行状态并设置告警规则。 实时可靠 原始采样数据实时上报，提供对云服务的实时监控，实时触发产生告警并通知用户。
修改告警规则 功能介绍 修改告警规则。 告警规则V1接口只支持配置单资源单策略规则，建议使用批量增加告警规则资源、批量删除告警规则资源和修改告警规则策略(全量修改)与前端功能配套使用。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成
告警规则简介 云监控服务支持灵活的创建告警规则。您既可以根据实际需要对某个特定的监控指标设置自定义告警规则，同时也支持使用告警模板为多个资源或者云服务批量创建告警规则。 在您使用告警模板创建告警规则之前，云监控服务已经根据各个云服务的应用属性以及云监控服务多年的开发、维护经验，为各个云服务量身定做了默认使用的告警模板
快速入门 概述 本节通过调用一系列云监控的API为ECS的cpu_util指标创建告警规则，当指标的数值达到设置的阈值时及时通知用户处理。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。 操作步骤 Token
批量创建Agent任务 功能介绍 批量创建Agent任务 接口约束 目前拉美-布宜诺斯艾利斯一、拉美-利马一2个局点不支持该接口 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
查询Agent任务列表 功能介绍 查询Agent任务列表 接口约束 目前拉美-布宜诺斯艾利斯一、拉美-利马一2个局点不支持该接口 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
