# API概览 通过使用云监控所提供的接口，您可以完整地使用云监控的所有功能。例如查询指标列表、创建告警规则等。 表1接口说明 | **类型** | **子类型** | **API** | **说明** | |:---|:---|:---|:---| | API V1 | API版本号管理 | [查询API所有版本（ListAllVersion）](https://support.huaweicloud.com/api-ces/ces_03_0020.html) | 查询云监控支持的API所有版本号。 | | API V1 | API版本号管理 | [查询API指定版本号（ShowSpecificVersion）](https://support.huaweicloud.com/api-ces/ces_03_0021.html) | 查询云监控API指定版本号。 | | API V1 | 指标管理 | [查询指标列表（ListMetrics）](https://support.huaweicloud.com/api-ces/ces_03_0023.html) | 查询系统当前可监控指标的列表。 | | API V1 | 告警规则管理 | [查询告警规则列表（ListAlarms）](https://support.huaweicloud.com/api-ces/ces_03_0027.html) | 查询系统当前告警规则列表。 | | API V1 | 告警规则管理 | [查询单条告警规则信息（ShowAlarm）](https://support.huaweicloud.com/api-ces/ces_03_0028.html) | 根据告警ID查询告警规则信息。 | | API V1 | 告警规则管理 | [启停告警规则（UpdateAlarmAction）](https://support.huaweicloud.com/api-ces/ces_03_0029.html) | 根据告警ID启动或停止一条告警规则。 | | API V1 | 告警规则管理 | [删除告警规则（DeleteAlarm）](https://support.huaweicloud.com/api-ces/ces_03_0030.html) | 根据告警ID删除一条告警规则。 | | API V1 | 告警规则管理 | [创建告警规则（CreateAlarm）](https://support.huaweicloud.com/api-ces/ces_03_0031.html) | 为系统当前的指标创建一条告警规则。 | | API V1 | 告警规则管理 | [创建自定义告警模板（CreateAlarmTemplate）](https://support.huaweicloud.com/api-ces/ces_03_0062.html) | 创建自定义告警模板来添加一个或者多个指标的告警规则。 | | API V1 | 告警规则管理 | [删除自定义告警模板（DeleteAlarmTemplate）](https://support.huaweicloud.com/api-ces/ces_03_0063.html) | 删除自定义告警模板。 | | API V1 | 告警规则管理 | [查询告警历史（ListAlarmHistories）](https://support.huaweicloud.com/api-ces/ces_03_0064.html) | 根据告警ID查询告警历史。 | | API V1 | 告警规则管理 | [查询自定义告警模板列表（ListAlarmTemplates）](https://support.huaweicloud.com/api-ces/ces_03_0065.html) | 查询自定义告警模板列表。 | | API V1 | 告警规则管理 | [更新自定义告警模板（UpdateAlarmTemplate）](https://support.huaweicloud.com/api-ces/ces_03_0066.html) | 更新自定义告警模板。 | | API V1 | 告警规则管理 | [修改告警规则（UpdateAlarm）](https://support.huaweicloud.com/api-ces/ces_03_0069.html) | 修改告警规则。 | | API V1 | 监控数据管理 | [查询监控数据（ShowMetricData）](https://support.huaweicloud.com/api-ces/ces_03_0033.html) | 查询指定时间范围指定指标的指定粒度的监控数据。 | | API V1 | 监控数据管理 | [添加监控数据（CreateMetricData）](https://support.huaweicloud.com/api-ces/zh-cn_topic_0032831274.html) | 添加一条或多条指标监控数据。 | | API V1 | 监控数据管理 | [批量查询监控数据（BatchListMetricData）](https://support.huaweicloud.com/api-ces/ces_03_0034.html) | 批量查询指定时间范围内指定指标的指定粒度的监控数据，目前最多支持10指标的批量查询。 | | API V1 | 监控数据管理 | [查询主机配置数据（ShowEventData）](https://support.huaweicloud.com/api-ces/ces_03_0035.html) | 查询指定时间范围指定事件类型的主机配置数据，可以通过参数指定需要查询的数据维度。 | | API V1 | 配额管理 | [查询配额（ShowQuotas）](https://support.huaweicloud.com/api-ces/ces_03_0037.html) | 查询告警规则配额。 | | API V1 | 资源分组管理 | [查询资源分组下的资源（ShowResourceGroup）](https://support.huaweicloud.com/api-ces/ces_03_0068.html) | 查询资源分组下的资源。 | | API V1 | 资源分组管理 | [创建资源分组（CreateResourceGroup）](https://support.huaweicloud.com/api-ces/ces_03_0070.html) | 创建资源分组。 | | API V1 | 资源分组管理 | [更新资源分组（UpdateResourceGroup）](https://support.huaweicloud.com/api-ces/ces_03_0071.html) | 更新资源分组。 | | API V1 | 资源分组管理 | [删除资源分组（DeleteResourceGroup）](https://support.huaweicloud.com/api-ces/ces_03_0072.html) | 删除资源分组。 | | API V1 | 资源分组管理 | [查询所有资源分组（ListResourceGroup）](https://support.huaweicloud.com/api-ces/ces_03_0073.html) | 查询所创建的所有资源分组。 | | API V1 | 事件监控 | [上报事件（CreateEvents）](https://support.huaweicloud.com/api-ces/zh-cn_topic_0109034020.html) | 通过该接口上报自定义事件。 | | API V1 | 事件监控 | [查询事件监控列表（ListEvents）](https://support.huaweicloud.com/api-ces/ces_03_0074.html) | 查询事件列表，包括系统事件和自定义事件。 | | API V1 | 事件监控 | [查询某一事件监控详情（ListEventDetail）](https://support.huaweicloud.com/api-ces/ces_03_0075.html) | 根据事件监控名称，查询该事件发生的详细信息。 | | API V2 | 告警规则 | [创建告警规则（CreateAlarmRules）](https://support.huaweicloud.com/api-ces/CreateAlarmRules.html) | 创建告警规则。 | | API V2 | 告警规则 | [批量删除告警规则（BatchDeleteAlarmRules）](https://support.huaweicloud.com/api-ces/BatchDeleteAlarmRules.html) | 批量删除告警规则。 | | API V2 | 告警规则 | [批量启停告警规则（BatchEnableAlarmRules）](https://support.huaweicloud.com/api-ces/BatchEnableAlarmRules.html) | 批量启停告警规则。 | | API V2 | 告警规则 | [查询告警规则列表（ListAlarmRules）](https://support.huaweicloud.com/api-ces/ListAlarmRules.html) | 查询告警规则列表 | | API V2 | 告警资源 | [批量增加告警规则资源（AddAlarmRuleResources）](https://support.huaweicloud.com/api-ces/AddAlarmRuleResources.html) | 批量增加告警规则资源(资源分组类型的告警规则不支持)。 | | API V2 | 告警资源 | [批量删除告警规则资源（DeleteAlarmRuleResources）](https://support.huaweicloud.com/api-ces/DeleteAlarmRuleResources.html) | 批量删除告警规则资源（资源分组类型的告警规则不支持）。 | | API V2 | 告警资源 | [查询告警规则资源列表（ListAlarmRuleResources）](https://support.huaweicloud.com/api-ces/ListAlarmRuleResources.html) | 根据告警规则ID查询告警规则资源列表。 | | API V2 | 告警策略 | [修改告警规则策略(全量修改)（UpdateAlarmRulePolicies）](https://support.huaweicloud.com/api-ces/UpdateAlarmRulePolicies.html) | 修改告警规则策略(全量修改)。 | | API V2 | 告警策略 | [查询告警规则策略列表（ListAlarmRulePolicies）](https://support.huaweicloud.com/api-ces/ListAlarmRulePolicies.html) | 根据告警规则ID查询策略列表。 | | API V2 | 告警通知 | [修改告警规则告警通知信息（UpdateAlarmNotifications）](https://support.huaweicloud.com/api-ces/UpdateAlarmNotifications.html) | 修改告警规则告警通知信息。 | | API V2 | 告警记录 | [查询告警记录列表（ListAlarmHistories）](https://support.huaweicloud.com/api-ces/ListAlarmHistories.html) | 查询告警记录列表。 | | API V2 | 告警模板 | [创建自定义告警模板（CreateAlarmTemplate）](https://support.huaweicloud.com/api-ces/CreateAlarmTemplate.html) | 创建自定义告警模板。 | | API V2 | 告警模板 | [批量删除自定义告警模板（BatchDeleteAlarmTemplates）](https://support.huaweicloud.com/api-ces/BatchDeleteAlarmTemplates.html) | 批量删除自定义告警模板。 | | API V2 | 告警模板 | [修改自定义告警模板（UpdateAlarmTemplate）](https://support.huaweicloud.com/api-ces/UpdateAlarmTemplate.html) | 修改自定义告警模板。 | | API V2 | 告警模板 | [查询告警模板列表（ListAlarmTemplates）](https://support.huaweicloud.com/api-ces/ListAlarmTemplates.html) | 查询告警模板列表。 | | API V2 | 告警模板 | [查询告警模板详情（ShowAlarmTemplate）](https://support.huaweicloud.com/api-ces/ShowAlarmTemplate.html) | 查询告警模板详情。 | | API V2 | 告警模板关联告警规则 | [查询告警模板关联的告警规则列表（ListAlarmTemplateAssociationAlarms）](https://support.huaweicloud.com/api-ces/ListAlarmTemplateAssociationAlarms.html) | 查询告警模板关联的告警规则列表。 | | API V2 | 资源分组 | [创建资源分组（CreateResourceGroup）](https://support.huaweicloud.com/api-ces/CreateResourceGroup.html) | 创建资源分组。 | | API V2 | 资源分组 | [批量删除资源分组（BatchDeleteResourceGroups）](https://support.huaweicloud.com/api-ces/BatchDeleteResourceGroups.html) | 批量删除资源分组。 | | API V2 | 资源分组 | [修改资源分组（UpdateResourceGroup）](https://support.huaweicloud.com/api-ces/UpdateResourceGroup.html) | 修改资源分组。 | | API V2 | 资源分组 | [查询指定资源分组详情（ShowResourceGroup）](https://support.huaweicloud.com/api-ces/ShowResourceGroup.html) | 查询指定资源分组详情。 | | API V2 | 资源分组 | [查询资源分组列表（ListResourceGroups）](https://support.huaweicloud.com/api-ces/ListResourceGroups.html) | 查询资源分组列表。 | | API V2 | 资源分组 | [资源分组异步关联自定义告警模板（UpdateResourceGroupAssociationAlarmTemplate）](https://support.huaweicloud.com/api-ces/UpdateResourceGroupAssociationAlarmTemplate.html) | 提交资源分组批量关联自定义告警模板异步任务，由异步任务覆盖性创建告警规则。 | | API V2 | 资源分组关联资源 | [自定义资源分组批量增加关联资源（BatchCreateResources）](https://support.huaweicloud.com/api-ces/BatchCreateResources.html) | 给自定义资源分组，即类型为手动添加的资源分组，批量增加关联资源。 | | API V2 | 资源分组关联资源 | [自定义资源分组批量删除关联资源（BatchDeleteResources）](https://support.huaweicloud.com/api-ces/BatchDeleteResources.html) | 给自定义资源分组，即类型为手动添加的资源分组，批量删除关联资源。 | | API V2 | 资源分组关联资源 | [查询资源分组下指定服务类别特定维度的资源列表（ListResourceGroupsServicesResources）](https://support.huaweicloud.com/api-ces/ListResourceGroupsServicesResources.html) | 查询资源分组下指定服务类别特定维度的资源列表。 | | API V2 | 一键告警 | [创建一键告警（CreateOneClickAlarm）](https://support.huaweicloud.com/api-ces/CreateOneClickAlarm.html) | 创建一键告警。 | | API V2 | 一键告警 | [查询一键告警列表（ListOneClickAlarms）](https://support.huaweicloud.com/api-ces/ListOneClickAlarms.html) | 查询一键告警列表。 | | API V2 | 一键告警 | [查询一键告警关联告警规则列表（ListOneClickAlarmRules）](https://support.huaweicloud.com/api-ces/ListOneClickAlarmRules.html) | 查询一键告警关联告警规则列表。 | | API V2 | 一键告警 | [批量修改一键告警关联告警规则的启用状态（BatchUpdateOneClickAlarmsEnabledState）](https://support.huaweicloud.com/api-ces/BatchUpdateOneClickAlarmsEnabledState.html) | 批量修改一键告警关联告警规则的启用状态。 | | API V2 | 一键告警 | [批量删除一键告警（BatchDeleteOneClickAlarms）](https://support.huaweicloud.com/api-ces/BatchDeleteOneClickAlarms.html) | 批量删除一键告警。 | | API V2 | 一键告警 | [批量修改开启状态的一键告警关联告警规则的告警通知（UpdateOneClickAlarmNotifications）](https://support.huaweicloud.com/api-ces/UpdateOneClickAlarmNotifications.html) | 批量修改开启状态的一键告警关联告警规则的告警通知。 | | API V2 | 一键告警 | [批量修改一键告警关联告警规则策略的启用状态（BatchUpdateOneClickAlarmPoliciesEnabledState）](https://support.huaweicloud.com/api-ces/BatchUpdateOneClickAlarmPoliciesEnabledState.html) | 批量修改一键告警关联告警规则策略的启用状态。 | | API V2 | 告警通知屏蔽 | [批量设置告警通知屏蔽规则（BatchUpdateNotificationMasks）](https://support.huaweicloud.com/api-ces/BatchUpdateNotificationMasks.html) | 批量设置告警通知屏蔽规则。 | | API V2 | 告警通知屏蔽 | [批量修改告警通知屏蔽规则的屏蔽时间（BatchUpdateNotificationMaskTime）](https://support.huaweicloud.com/api-ces/BatchUpdateNotificationMaskTime.html) | 批量修改告警通知屏蔽规则的屏蔽时间。 | | API V2 | 告警通知屏蔽 | [修改告警通知屏蔽规则（UpdateNotificationMask）](https://support.huaweicloud.com/api-ces/UpdateNotificationMask.html) | 修改告警通知屏蔽规则。 | | API V2 | 告警通知屏蔽 | [批量删除告警通知屏蔽规则（BatchDeleteNotificationMasks）](https://support.huaweicloud.com/api-ces/BatchDeleteNotificationMasks.html) | 批量删除告警通知屏蔽规则。 | | API V2 | 告警通知屏蔽 | [查询告警通知屏蔽列表（ListNotificationMasks）](https://support.huaweicloud.com/api-ces/ListNotificationMasks.html) | 查询告警通知屏蔽列表。 | | API V2 | 告警通知屏蔽 | [查询告警通知屏蔽资源列表（ListNotificationMaskResources）](https://support.huaweicloud.com/api-ces/ListNotificationMaskResources.html) | 查询告警通知屏蔽资源列表。 | | API V2 | 监控看板 | [创建/复制监控看板（CreateOneDashboard）](https://support.huaweicloud.com/api-ces/CreateOneDashboard.html) | 创建/复制监控看板。 | | API V2 | 监控看板 | [查询监控看板列表（ListDashboardInfos）](https://support.huaweicloud.com/api-ces/ListDashboardInfos.html) | 查询监控看板列表。 | | API V2 | 监控看板 | [修改监控看板（UpdateDashboard）](https://support.huaweicloud.com/api-ces/UpdateDashboard.html) | 修改监控看板。 | | API V2 | 监控看板 | [批量删除监控看板（DeleteDashboards）](https://support.huaweicloud.com/api-ces/DeleteDashboards.html) | 批量删除监控看板。 | | API V2 | 监控视图 | [创建/复制/批量创建监控视图到指定的监控看板（CreateDashboardWidgets）](https://support.huaweicloud.com/api-ces/CreateDashboardWidgets.html) | 创建/复制/批量创建监控视图到指定的监控看板。 | | API V2 | 监控视图 | [查询指定监控看板下的监控视图列表（ListDashboardWidgets）](https://support.huaweicloud.com/api-ces/ListDashboardWidgets.html) | 查询指定监控看板下的监控视图列表。 | | API V2 | 监控视图 | [查询指定监控视图信息（ShowWidget）](https://support.huaweicloud.com/api-ces/ShowWidget.html) | 查询指定监控视图信息。 | | API V2 | 监控视图 | [删除指定监控视图（DeleteOneWidget）](https://support.huaweicloud.com/api-ces/DeleteOneWidget.html) | 删除指定监控视图。 | | API V2 | 监控视图 | [批量更新监控视图（BatchUpdateWidgets）](https://support.huaweicloud.com/api-ces/BatchUpdateWidgets.html) | 批量更新监控视图. | | API V2 | 资源标签管理 | [查询CES指定项目指定资源类型标签列表（ListCesTargetProjectTags）](https://support.huaweicloud.com/api-ces/ListCesTargetProjectTags.html) | 查询CES指定项目指定资源类型标签列表 | | API V2 | 指标管理 | [查询主机监控维度指标信息（ListAgentDimensionInfo）](https://support.huaweicloud.com/api-ces/ListAgentDimensionInfo.html) | 根据ECS/BMS资源ID查询磁盘、挂载点、进程、显卡、RAID控制器维度指标信息。 | | API V2 | 指标管理 | [查询主机监控维度指标信息（ListAgentDimensionInfo）](https://support.huaweicloud.com/api-ces/BatchListSpecifiedMetricData.html) | 批量查询指标数据 | | API V3 | 插件状态查询 | [插件状态查询（ListAgentStatus）](https://support.huaweicloud.com/api-ces/ListAgentStatus.html) | 插件状态查询，包括uniagent状态以及插件状态。 | | API V3 | Agent任务相关接口 | [查询Agent任务列表（ListAgentInvocations）](https://support.huaweicloud.com/api-ces/ListAgentInvocations.html) | 查询Agent任务列表。 | | API V3 | Agent任务相关接口 | [批量创建Agent任务（BatchCreateAgentInvocations）](https://support.huaweicloud.com/api-ces/BatchCreateAgentInvocations.html) | 批量创建Agent任务。 |