Create Tag

[ 1 HTTP Request ] [ 1.1 Parameters ] [ 2 Request Example ] [ 3 Response Example ] [ 4 Sample Code ]

이 API는 machlake에서 하나의 센서를 표시하기 위해 사용되는 tag를 생성한다. Tag를 생성할 때 이미 디자인한 스키마와 같은 형태로 데이터를 입력해야 한다. 여러개의 tag를 한꺼번에 등록할 수 있다. Tag 생성 API를 수행하여 결과가 성공이면 입력한 데이터에 따라 Tag의 id와 정보들이 입력되고 입력 결과를 json arry형태로 반환한다.

HTTP Request

Copy Copy to clipboard
POST https://${CloudVendor}.${CountryCode}.machlake.com/lakes/${lake_id}/tags
 
{
    "tag" : [["{tag_name}", {additional value 1}, "{additional value 2}"], [ second tag values ], ...]
}

Parameters

no parameters

Request Example

POST https://aws1.us.machlake.com/lakes/xbacd1234/tags

{
    "tag" : [["newtag01"], ["newtag02"]]
}

Response Example

POST https://aws1.us.machlake.com/lakes/xbacd1234/tags

{
    "tag" : [["newtag01"], ["newtag02"]]
}

Sample Code

이 예제는 sensor1, sensor2의 이름을 갖는 tag를 생성한다. Tag_schema 메타정보는 name column만을 갖는 상황이므로 json데이터는 name_variable의 배열로 구성되었다. Tag_schema가 다른 경우 추가 필드값이 필요할 수 있다.

Type	Github Link

Type	Github Link
curl-bash	https://github.com/machlake/api_example/blob/main/script/linux/TagCreate.sh
js	https://github.com/machlake/api_example/blob/main/nodejs/TagCreate.js
python	https://github.com/machlake/api_example/blob/main/python/TagCreate.py

2022 서울시 IoT 공공도시데이터 활용 해커톤을 위한 매뉴얼