检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 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 API版本号 云资源监控 资源配额 事件监控 告警 资源分组
API 批量查询监控数据 查询监控数据
如何调用API 构造请求 认证鉴权 返回结果
事件监控接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 上报自定义事件。 POST /V1.0/{project_id}/events ces:events:post √ × 父主题： 权限和授权项
即响应参数metrics属性对应对象datapoints属性累加最多返回3000个数据点）。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /V1.0/{
API版本号 API版本号管理 父主题： API
API版本号管理接口授权项说明 权限 对应API接口 授权项 IAM项目 企业项目 查询云监控支持的API所有版本号。 GET / ces:versions:get √ × 查询云监控API指定版本号。 GET /{api_version} ces:versions:get √ ×
API版本号管理 查询API所有版本 查询API指定版本号 父主题： API版本号
查询API所有版本 功能介绍 查询云监控支持的API所有版本号。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET / 请求消息 请求样例 GET https://{云监控的终端节点}/
查询API指定版本号 功能介绍 查询云监控API指定版本号。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /{api_version} 参数说明 表1 参数说明
创建告警规则（推荐） 功能介绍 创建告警规则（推荐） 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v2/{project_id}/alarms 表1 路径参数
功能介绍 修改告警规则。 告警规则V1接口只支持配置单资源单策略规则，建议使用批量增加告警规则资源、批量删除告警规则资源和修改告警规则策略(全量修改)与前端功能配套使用。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK
ces.0004 未指定API版本号 The API version must be specified. 在请求URL中增加API版本号 400 ces.0005 API版本不正确 The API version is incorrect. 使用正确的API版本号 400 ces
快速入门 概述 本节通过调用一系列云监控的API为ECS的cpu_util指标创建告警规则，当指标的数值达到设置的阈值时及时通知用户处理。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。 操作步骤 Token认证，具体操作请参考认证鉴权。
Agent任务相关接口 Agent任务相关接口 查询Agent任务列表 批量创建Agent任务 父主题： 云资源监控
告警资源 批量增加告警规则资源 批量删除告警规则资源 查询告警规则资源列表 父主题： 告警
批量创建Agent任务 功能介绍 批量创建Agent任务 接口约束 目前拉美-布宜诺斯艾利斯一、拉美-利马一2个局点不支持该接口 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
告警 告警规则管理 告警资源 告警策略 告警通知 告警记录 告警模板 告警模板关联告警规则 一键告警 告警通知屏蔽 父主题： API
查询Agent任务列表 功能介绍 查询Agent任务列表 接口约束 目前拉美-布宜诺斯艾利斯一、拉美-利马一2个局点不支持该接口 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
