API概览

更新时间:
复制为 MD 格式

API标准及多语言预置SDK

本产品(ARMS/2019-08-08)的OpenAPI采用RPC签名风格。我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(147535001692),在专家指导下进行签名对接。

在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

自定义签名场景

若您的业务场景有特殊需求,需通过自签名方式对接 API,建议优先咨询我们的技术支持团队(服务钉钉群:147535001692),获取专业指导以确保高效接入。

账号与安全准备

阿里云账号具备对所有资源的完全管理权限。一旦 AccessKey 泄露,所有相关资源都将面临未经授权访问的风险。为确保安全,建议创建一个仅具备 API 访问权限的RAM用户并配置其 AccessKey,同时基于最小权限原则 (PoLP) 配置 RAM 策略。仅在明确需要阿里云账号权限的特定场景下,才使用阿里云账号。

可观测监控 Prometheus 版

API

标题

API概述

DescribeEnvDropMetricsRule 查询接入环境的废弃指标规则 查询指定环境实例的废弃指标列表。
UpdateEnvDropMetricsRule 更新环境中废弃指标规则 更新环境中废弃指标规则。
AddTagToFlinkCluster Prometheus Flink集群打标 主要将用户Flink工作空间对应的Prometheus实例打上工作空间ID、工作空间名称这两个Tag。
CreateEnvironment 创建环境 创建环境实例。
InitEnvironment 初始化环境实例 初始化环境实例。
DescribeEnvironment 查询环境详情 查询环境详情。
UpdateEnvironment 更新环境信息 更新环境信息。
ListEnvironments 查询环境列表 查询环境列表。
DeleteEnvironment 删除环境 删除环境实例。
DescribeAddonMetrics 查询Addon指标信息 查询指定Addon的指标详情。
InstallEnvironmentFeature 安装Feature 安装Feature。
DescribeEnvironmentFeature 查询Feature详情 查询Feature详情。
UpgradeEnvironmentFeature 更新Feature 更新Feature信息。
RestartEnvironmentFeature 重启Feature 重启feature。
ListEnvironmentFeatures 查询环境中的Feature 查询环境中的Feature。
DeleteEnvironmentFeature 删除feature 删除feature。
CreateEnvCustomJob 创建环境的自定义Job 创建环境的自定义Job。
UpdateEnvCustomJob 更新环境的自定义Job 更新环境的自定义Job。
ListEnvCustomJobs 查询环境的自定义Job列表 查询环境的自定义Job列表。
DescribeEnvCustomJob 查询环境CustomJob详情 查询环境CustomJob详情。
DeleteEnvCustomJob 删除环境的自定义Job 删除环境的自定义job。
CreateEnvPodMonitor 创建环境的PodMonitor 创建环境的PodMonitor。
DescribeEnvPodMonitor 查询环境的PodMonitor详情 查询环境的PodMonitor详情。
ListEnvPodMonitors 查询环境的PodMonitor列表 查询环境的PodMonitor列表。
UpdateEnvPodMonitor 更新环境的PodMonitor 更新环境的PodMonitor。
DeleteEnvPodMonitor 删除环境PodMonitor 删除环境PodMonitor。
CreateEnvServiceMonitor 创建环境的ServiceMonitor 创建环境的ServiceMonitor。
DescribeEnvServiceMonitor 查询环境的ServiceMonitor详情 查询环境的ServiceMonitor详情。
ListEnvServiceMonitors 查询环境的ServiceMonitor列表 查询环境的ServiceMonitor列表。
UpdateEnvServiceMonitor 更新环境的ServiceMonitor 更新环境的ServiceMonitor。
DeleteEnvServiceMonitor 删除环境ServiceMonitor 删除环境ServiceMonitor。
InstallAddon 安装Addon信息 安装Addon信息。
DescribeAddonRelease 查看AddonRelease详情 通过名称查询AddonRelease详情。
ListAddons 查询addon列表 新版接入中心产品列表。
UpgradeAddonRelease 更新AddonRelease信息 更新AddonRelease信息。
ListAddonReleases 查询环境中安装的Addon 查询环境中安装的Addon。
DeleteAddonRelease 删除AddonRelease信息 通过AddonRelease名称删除AddonRelease数据。
ListEnvironmentDashboards 查询环境中的大盘信息 查询环境中的大盘信息。
EnableMetric 启用单个废弃指标 启用废弃指标。
UpdateMetricDrop 更新废弃指标列表 更新废弃指标列表。
UpdatePrometheusMonitoringStatus 更新Prometheus实例监控配置状态 更新Prometheus实例监控配置状态。
UpdatePrometheusMonitoring 更新Prometheus实例监控配置 更新Prometheus实例监控配置。
ListPrometheusMonitoring 查询Prometheus实例监控配置 查询Prometheus实例监控配置。
GetPrometheusMonitoring 查询Prometheus实例指定监控配置 查询Prometheus实例指定监控配置。
DeletePrometheusMonitoring 删除Prometheus实例监控配置 删除Prometheus实例监控配置。
CreatePrometheusMonitoring 创建Prometheus实例的监控配置 创建Prometheus实例的监控配置。
AppendInstancesToPrometheusGlobalView 新增Prometheus实例数据源 增加ARMS Prometheus监控聚合实例中的数据源,将数据源添加到Prometheus聚合实例。
AddPrometheusInstance 创建RemoteWrite类型的Prometheus实例 创建RemoteWrite类型Prometheus实例。
AddPrometheusGlobalViewByAliClusterIds 新增容器聚合实例 增加ARMS Prometheus监控的聚合实例。
AddPrometheusGlobalView 新增聚合实例 增加ARMS Prometheus监控的聚合实例。
AddAliClusterIdsToPrometheusGlobalView 新增聚合实例数据源 增加ARMS Prometheus监控聚合实例的数据源。
AddRecordingRule 创建RecordingRule 创建或者更新Prometheus监控的RecordingRule规则。
SyncRecordingRules 将某个集群的聚合规则批量同步到全Region的其他目标集群 将某个集群的聚合规则批量同步到全Region的其他目标集群。
AddIntegration 集成大盘及采集规则 集成ARMS Prometheus监控的大盘以及采集规则。
GetIntegrationState 获取Integration的接入状态 来获取Integration的接入状态。
DeleteIntegration 删除Integration接入的采集规则 删除Integration接入的采集规则。
AddGrafana 集成Prometheus监控大盘 集成ARMS Prometheus监控的大盘。
InstallCmsExporter 安装云服务采集器 安装云服务采集器。
OpenVCluster 开通虚拟集群 开通虚拟集群。
DeletePrometheusGlobalView 删除Prometheus聚合实例 删除Prometheus聚合实例。
RemoveAliClusterIdsFromPrometheusGlobalView 删除聚合实例数据源 移除ARMS Prometheus监控聚合实例的某些数据源。
RemoveSourcesFromPrometheusGlobalView 删除聚合实例非阿里数据源 移除ARMS Prometheus监控聚合实例中的数据源,仅支持删除非阿里数据源。
DeleteCmsExporter 卸载Prometheus for 云服务实例 来卸载Prometheus for 云服务实例。
DelAuthToken 关闭鉴权token 关闭鉴权token。
DeleteGrafanaResource 删除集群的大盘资源 删除ARMS Prometheus监控集群中的Grafana大盘资源。
UninstallPromCluster 卸载prometheus集群 来卸载ARMS Prometheus集群实例。
QueryPromInstallStatus 查询集群安装状态 来查询ARMS Prometheus集群的安装状态。
ListPrometheusGlobalView 获取聚合实例列表 增加ARMS Prometheus监控的聚合实例,获取聚合实例列表。
GetPrometheusGlobalView 获取聚合实例的数据源详情 增加ARMS Prometheus监控的聚合实例,获取指定聚合实例的详细数据源情况。
CheckServiceStatus 检查产品开通状态 检查集群当前的服务状态,例如是否开通服务,是否欠费等。
GetPrometheusApiToken 获取Prometheus监控所需Token 获取集成ARMS Prometheus监控所需的Token。
GetExploreUrl 获取GrafanaExplore功能 获取使用GrafanaExplore功能。
ListDashboards 获取集群的大盘列表 获取集群的Grafana大盘的列表。
ListClusterFromGrafana 列出指定地域下的所有Grafana大盘 列出指定地域下的所有Grafana大盘。
GetRecordingRule 获取聚合规则 获取集群的RecordingRule聚合规则。
ListCmsInstances 查询云服务采集状态 查询云服务采集状态。
ListDashboardsByName 创建Loki数据源和相关的多数据源大盘 来创建与Prometheus关联的Loki数据源和相关的多数据源大盘。
GetAuthToken 获取公网读写鉴权 获取公网读写鉴权Token。
GetClusterAllUrl 获取集群所有地址 获取集群所有地址。包括远程读写地址、 Push Gateway地址、 Grafana地址。
GetCloudClusterAllUrl 获取云产品各种URL 获取云监控云产品读写地址,pushgateway,grafana 地址。
ListPrometheusInstances 获取所有正常实例 获取Prometheus的所有正常实例。
InstallManagedPrometheus 创建托管Prometheus 创建托管(ASK/ECS)Prometheus。
UninstallManagedPrometheus 卸载托管Prometheus 卸载托管(ASK/ECS/ACKoNE)Prometheus。
GetManagedPrometheusStatus 获取托管版Prometheus安装状态 获取托管版(ask、ecsone)Prometheus实例的安装状态。
BindPrometheusGrafanaInstance 绑定Prometheus实例使用的Grafana工作区ID 绑定Prometheus实例使用的Grafana工作区ID。
AddPrometheusIntegration 增加Prometheus实例的集成中心Exporter实例 增加Prometheus实例的集成中心Exporter实例(仅支持aliyun-cs、ecs两种类型的实例)。
UpdatePrometheusIntegration 更改Prometheus实例集成中心Exporter配置 更改Prometheus实例(仅支持aliyun-cs、ecs两种类型的实例)集成中心Exporter配置。
DeletePrometheusIntegration 删除Prometheus实例集成中心Exporter实例 删除Prometheus实例集成中心Exporter实例(仅支持aliyun-cs、ecs两种类型的实例)。
GetPrometheusIntegration 获取Prometheus实例指定集成中心Exporter实例 获取Prometheus实例(仅支持aliyun-cs、ecs两种类型的实例)指定集成中心Exporter实例。
ListPrometheusIntegration 查询Prometheus实例集成中心Exporter实例列表 查询Prometheus实例(仅支持aliyun-cs、ecs两种类型的实例)集成中心Exporter实例列表。
GetPrometheusInstance 获取指定Prometheus实例信息 获取指定Prometheus实例信息。
ListPrometheusInstanceByTagAndResourceGroupId 根据标签和资源组查询Prometheus实例 根据标签和资源组查询Prometheus实例。
CreatePrometheusInstance 新建Prometheus实例 新建Prometheus实例。
UpdatePrometheusInstance 更新Prometheus实例信息 更新Prometheus实例信息。
UpdatePrometheusGlobalView 更新Prometheus for GlobalView聚合数据源 更新Prometheus for GlobalView聚合数据源。
ListEnvironmentKubeResources 查看环境的K8s资源 查看环境的K8s资源。
ListEnvironmentMetricTargets 查询环境中的Target列表 查询环境中的Target列表。
ListEnvironmentAddons 查询指定环境安装的Addon 查询指定环境安装的Addon信息。
ListEnvironmentAlertRules 查询环境中的告警组信息 查询环境中的告警组信息。

Prometheus报警规则(旧版)

API

标题

API概述

CreatePrometheusAlertRule 创建告警规则 创建告警规则。
DeletePrometheusAlertRule 删除告警规则 删除Prometheus告警规则。
UpdatePrometheusAlertRule 更新告警规则 调用UpdatePrometheusAlertRule接口更新Prometheus报警规则。
DescribePrometheusAlertRule 查看告警规则 查看Prometheus告警规则。
ListPrometheusAlertRules 查看告警规则列表 查看Prometheus告警规则列表。
ListPrometheusAlertTemplates 查看告警模板列表 调用ListPrometheusAlertTemplates接口查看Prometheus告警模板列表。

访问控制

API

标题

API概述

OpenArmsServiceSecondVersion 开通ARMS 开通ARMS下指定子产品的后付费功能。
OpenXtraceDefaultSLR 开通可观测链路 OpenTelemetry 版服务关联角色 开通可观测链路 OpenTelemetry 版服务关联角色AliyunServiceRoleForXtrace。
OpenArmsDefaultSLR 开通ARMS服务关联角色 开通ARMS服务关联角色AliyunServiceRoleForARMS。
ChangeResourceGroup ARMS资源转组 修改资源所属资源组。
TagResources 创建标签资源关系 用于给ARMS资源实例打标签。
UntagResources 删除标签资源关系 用于删除ARMS资源实例标签。

产品计费

API

标题

API概述

GetCommercialStatus 获取商业化状态 查看当前账号是否开通对应产品的商业化版本。
CheckCommercialStatus 检查产品商业化状态 检查产品的商业化开通状态。
QueryCommercialUsage 查询可观测用量数据 查询写入量数据,支持应用监控、可观测链路OpenTelemetry版、Prometheus、用户体验监控四大产品用量数据。