Raw Value Select
- Grey Shim
MachLake에 입력된 원본 센서 데이터를 얻기 위한 API이다.
HTTP Request
GET https://${CloudVendor}.${CountryCode}.machlake.com/lakes/${lake_id}/values/raw
Content-Type: application/json; charset=utf8
x-api-key: {API Key}Parameters
Optional | Type | Description | Example |
|---|---|---|---|
tag_name | string | Tag의 이름. 여러개를 명시하려면 ',' 문자를 이용하여 나열할 수 있다. | &tag_name=tag1,tag2,tag3 |
start_time | string | 검색 시작 시간 (종료시간보다 적은 값이어야 함) 아래의 두가지 중 하나의 방법으로 설정 type 1 : 시간 문자열
type 2 : 밀리초 혹은 마이크로초 기반 타임스탬프
| &start_time=2018-01-16 14:40:05 000
|
separator | string | 매개변수의 tag_name, columns, and_condition들을 구분하는 구분자 | &separator=| (default : ,) |
value_return_form | int | 결과 출력 방법 | 0 : separate standard (default) |
and_condition | string | 검색 조건절(escape sequence설정이 필요)
| &and_condition=”value” > 345,”name” = 'sjkim' |
end_time | string | 검색 종료 시간 (start_time보다 커야 함)
| same as start_time |
date_format | string | Time값의 포멧 지정 DATE_FORMAT 혹은 timestamp 단위("SECOND", "MILLISECOND", "MICROSECOND", "NANOSECOND") | &date_format=YYYY-MM-DD HH24:MI:SS (default : YYYY-MM-DD HH24:MI:SS) |
offset | int | 검색후 건너뛸 데이터의 수 | &offset=500 |
limit | int | 출력할 데이터의 수 | &limit=1000 (default : Restricted by 'lake tier' by lake tier) |
columns | string | 표시할 컬럼의 이름 | &columns=value,value2 (default : value) |
aliases | string | 별명으로 표시할 칼럼의 이름 (Must be blank or equal to columns,) | &aliases=myvalue,myvalue2 |
direction | int | 오름차순 혹은 내림차순 설정 | &direction=0 : ascend (default) |
Request Example
GET https://aws1.us.machlake.com/lakes/xbacd1234/values/raw?tag_name=tag_01&start_time=2021-07-06 12:12:22&end_time=2021-07-06 12:12:27&columns=VALUE&aliases=MyVal&separator=,&limit=1000&value_return_form=0
Content-Type: application/json; charset=utf8
x-api-key: {API Key}Response Example
Status 200
// return format = 0
{
"status": "success",
"data": {
"calc_mode": "raw",
"columns": [
{"name": "TIME", "type": 5, "length": 4096},
{"name": "MyVal", "type": 20, "length": 17}
],
"samples": [
{
"tag_name": "tag_01",
"data": [
{"MyVal": 1234, "TIME": "2021-07-06 12:12:22"},
{"MyVal": 2345, "TIME": "2021-07-06 12:12:23"},
{"MyVal": 2346, "TIME": "2021-07-06 12:12:24"},
{"MyVal": 1625, "TIME": "2021-07-06 12:12:25"}
]
}
]
}
}
// return format = 1
{
"status": "success",
"data": {
"calc_mode": "raw",
"columns": [
{"name": "TIME", "type": 5, "length": 4096},
{"name": "MyVal", "type": 20, "length": 17}
],
"samples": [
{
"tag_name": "tag_01",
"data": {
"MyVal": [
1234,
2345,
2346,
1625
],
"TIME": [
"2021-07-06 12:12:22",
"2021-07-06 12:12:23",
"2021-07-06 12:12:24",
"2021-07-06 12:12:25"
]
}
}
]
}
}