4.1 监控
4.1.2 查询时序数据
}
状态码： 400
BadRequest 非法请求。建议直接修改该请求，不要重试该请求。
{ "error_code" : "AOM.04007500", "error_msg" : "internal server error", "error_type" : "INTERNAL_SERVER_ERROR"
}
状态码
状态码 描述
200 OK 请求执行完成。
400 BadRequest 非法请求。建议直接修改该请求，不要重试该请求。
401 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提 供的认证信息不正确或非法。
403 Forbidden 请求被拒绝访问。返回该状态码，表明请求能够到达服务 端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求 被设置为拒绝访问，建议直接修改该请求，不要重试该请求。
500 InternalServerError 表明服务端能被请求访问到，但是不能理解用户的 请求。
503 ServiceUnavailable 被请求的服务无效。建议直接修改该请求，不要重 试该请求。
错误码
请参见错误码。
4.1.2 查询时序数据
功能介绍
该接口用于查询指定时间范围内的监控时序数据，可以通过参数指定需要查询的数据 维度，数据周期等。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/{project_id}/samples
表4-11 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 租户从IAM申请到的projectid，
一般为32位字符串。
表4-12 Query 参数
参数 是否必选 参数类型 描述
fill_value 否 String 用于对查询到的时序数据进行断 点插值，默认值为-1。 -1：断 点处使用-1进行表示。 0 ：断 点处使用0进行表示。 null：断 点处使用null进行表示。
average：断点处使用前后邻近 的有效数据的平均值进行表示，
如果不存在有效数据则使用null 进行表示。
请求参数
表4-13 请求 Body 参数
参数 是否必选 参数类型 描述
samples 是 Array of QuerySample objects
时序数据对象列表。 取值范 围：JSON数组大小不超过20。
statistics 是 Array of
strings 统计方式。 取值范围：
maximum，minimum，sum，
average，sampleCount。
period 是 Integer 监控数据粒度。 取值范围 枚举
值，取值范围： 60，1分钟粒 度； 300，5分钟粒度； 900，
15分钟粒度； 3600，1小时粒 度。
参数 是否必选 参数类型 描述
time_range 是 String 说明： time_range/
period≤1440 计算时，
time_range和period需换算为相
（2017-08-01 08:00 :00到 2017-08-02 08:00:00）可以表 示为1501545600000.15016320000 00.1440。
表4-14 QuerySample
参数 是否必选 参数类型 描述
namespace 是 String 时间序列命名空间。 取值范 围： PAAS.CONTAINER、
PAAS.NODE、PAAS.SLA、
PAAS.AGGR、
CUSTOMMETRICS等。
PAAS.CONTAINER：应用时间 序列命名空间； PAAS.NODE：
节点时间序列命名空间；
PAAS.SLA：SLA时间序列命名空 间； PAAS.AGGR：集群时间序 列命名空间；
CUSTOMMETRICS：自定义时 间序列命名空间。
dimensions 是 Array of DimensionSe ries objects
时间序列维度列表。 可通 过/v2/{project_id}/series接口中 namespace+metric_name，查 询当前监控的时间序列名称的时 间序列维度列表。
metric_name 是 String 时间序列名称。名称长度取值范 围为1~255个字符。 取值范 围： AOM提供的基础时间序列 名称，cpuUsage、
cpuCoreUsed等， cpuUage：
cpu使用率； cpuCoreUsed：
cpu内核占用； 用户上报的自定 义时间序列名称。
表4-15 DimensionSeries
参数 是否必选 参数类型 描述
name 否 String 维度名称。
value 否 String 维度取值。
响应参数
状态码： 200
表4-16 响应 Body 参数
参数 参数类型 描述
samples Array of SampleData Value objects
时间序列对象列表。
表4-17 SampleDataValue
参数 参数类型 描述
sample QuerySample
object 时间序列对象列表。
data_points Array of MetricDataP oints objects
时序数据。
表4-18 QuerySample
参数 参数类型 描述
namespace String 时间序列命名空间。 取值范围：
PAAS.CONTAINER、PAAS.NODE、PAAS.SLA、
PAAS.AGGR、CUSTOMMETRICS等。
PAAS.CONTAINER：应用时间序列命名空间；
PAAS.NODE：节点时间序列命名空间；
PAAS.SLA：SLA时间序列命名空间；
PAAS.AGGR：集群时间序列命名空间；
CUSTOMMETRICS：自定义时间序列命名空间。
dimensions Array of DimensionSe ries objects
时间序列维度列表。 可通过/v2/{project_id}/
series接口中namespace+metric_name，查询当 前监控的时间序列名称的时间序列维度列表。
参数 参数类型 描述
metric_name String 时间序列名称。名称长度取值范围为1~255个字 符。 取值范围： AOM提供的基础时间序列名 称，cpuUsage、cpuCoreUsed等， cpuUage：
cpu使用率； cpuCoreUsed：cpu内核占用； 用 户上报的自定义时间序列名称。
表4-19 DimensionSeries
参数 参数类型 描述
name String 维度名称。
value String 维度取值。
表4-20 MetricDataPoints
参数 参数类型 描述
statistics Array of StatisticValu e objects
统计方式。
timestamp Long 时间戳。
unit String 时间序列单位。
表4-21 StatisticValue
参数 参数类型 描述
statistic String 统计方式。
value Double 统计结果。
状态码： 400
表4-22 响应 Body 参数
参数 参数类型 描述
error_code String 错误码。
error_msg String 错误信息描述。
error_type String 错误类型。
请求示例
"time_range": "-1.-1.5",// 最近5分钟 "statistics": [
"timestamp" : "1467892800000", "unit" : "Percent",
BadRequest 非法请求。建议直接修改该请求，不要重试该请求。
{ "error_code" : "AOM.04008500", "error_msg" : "internal server error", "error_type" : "INTERNAL_SERVER_ERROR"
}
状态码
状态码 描述
200 OK 请求执行完成。
400 BadRequest 非法请求。建议直接修改该请求，不要重试该请求。
401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端 指出客户端所提供的认证信息不正确或非法。
403 Forbidden 请求被拒绝访问。返回该状态码，表明请求能够到达服务 端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求 被设置为拒绝访问，建议直接修改该请求，不要重试该请求。
500 InternalServerError 表明服务端能被请求访问到，但是不能理解用户的 请求。
503 ServiceUnavailable 被请求的服务无效。建议直接修改该请求，不要重 试该请求。
错误码
请参见错误码。