功能介绍

指定Metric查询时间戳最早的一条DataPoint。

如果该Metric最早的时间戳有多条不同tag的DataPoint，查询只返回一条DataPoint，时间戳单位是毫秒。

URI

• URI格式

  POST {OpenTSDB URL}/api/query/first

请求

• 请求样例

  {
  	"resolveNames":true,
  	"backScan":20,
  	"queries":[
  		{
  			"metric":"sys.cpu.nice"
  		},
  		{
  			"metric":"cpu.system"
  		}
  	]
  }

• 参数说明

  表1 请求参数说明

  名称	类型	是否必须	描述
  resolveNames	Boolean	否	是否将返回结果的tsuid转换为对应的metric、Tagk和Tagv名称。 true：转换 false：不转换
  backScan	Integer	否	设置需要扫描过去几个小时的数据，单位：小时。 数据存储以小时为单位，假设系统当前时间是2018/07/20 19:30:00，“backScan”设置为2，则查询的时间范围是2018/07/20 17:00:00到2106/01/01 00:00:00，而不是从2018/07/20 17:30:00开始，数据扫描会从2018/07/20 17:00:00开始直到找到第一条数据。 如果“backScan”不设置或者值为0，表示扫描所有时间。
  queries	Array	是	需要查询的metric列表，不支持指定Tag和tsuid，可以有多个子查询。

响应

• 响应样例

  [
      {
          "metric": "sys.cpu.nice",
          "timestamp": 1346846400000,
          "value": "18",
          "tags": {
              "host": "web01",
              "dc": "lga"
          },
          "tsuid": "00000E0000090007E500000A0007E6"
      },
      {
          "metric": "cpu.system",
          "timestamp": 1346846400000,
          "value": "9",
          "tags": {
              "host": "web02",
              "dc": "lga"
          },
          "tsuid": "00000F0000090007E700000A0007E6"
      }
  ]

• 参数说明

  表2 响应参数说明

  名称	类型	描述
  metric	String	指标名称
  timestamp	long	时间戳，单位：毫秒
  value	String	数据值
  tags	Map	Tagk和Tagv的键值对
  tsuid	String	metric、Tagk和Tagv对应的tsuid

状态码

状态码请参见响应码