查询Prometheus实例下符合指定标签筛选器条件的时间序列 - ListSeriesAomPrometheusInstance

功能介绍

该接口用于查询Prometheus实例中符合指定标签筛选器条件的时间序列。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
• 如果使用身份策略授权，需具备如下身份策略权限。

  授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
  aom:metric:list	List	-	-	aom:metric:get	-

URI

POST /v1/{project_id}/{prometheus_instance}/aom/api/v1/series

请求参数

响应参数

状态码：200

状态码：400

状态码：403

请求示例

• 查询所有包含标签 job="prometheus" 的时间序列。

  https://{EndPoint}/v1/{project_id}/{prometheus_instance}/aom/api/v1/series?match[]={job="prometheus"}

• 查询指标名称以 "http_request_" 开头且状态码为 "5xx" 的时间序列。

  https://{EndPoint}/v1/{project_id}/{prometheus_instance}/aom/api/v1/series?match[]={__name__=~"http_request_.*", status=~"5.."}

响应示例

状态码：200

OK 请求响应成功。

{
  "data" : [ {
    "__name__" : "aom_node_cpu_usage",
    "clusterId" : "00000000-0000-0000-0000-00000000",
    "hostID" : "17558d48-****-44c0-****-0a4f9159b6e5",
    "hostName" : "aomtest-console",
    "nameSpace" : "default",
    "nodeIP" : "10.**.1**.98",
    "nodeName" : "aomtest-console"
  } ],
  "status" : "success"
}

状态码：400

BadRequest 非法请求。建议直接修改该请求，不要重试该请求。

{
  "status" : "error",
  "errorType" : "bad_data",
  "error" : "invalid parameter \"match[]\": match[] must contain at least one non-empty matcher"
}

状态码：403

Forbidden 请求被拒绝访问。返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。

{
  "status" : "error",
  "errorType" : "auth",
  "error" : "auth project_id not pass."
}

状态码

错误码

请参见错误码。