이 API를 호출하면 등록된 모든 tag에 대한 정보를 반환한다. Tag_name 변수에 특정 단어를 입력하고 API를 호출하면 해당 단어를 포함하는 tag의 리스트를 반환한다. tag 수가 많아서 여러 페이지로 출력하고자 할 때에는 limit과 offset을 이용하면 된다.
HTTP Request
GET https://aws1.us.machlake.com/lakes/xbacd1234/tags
Content-Type: application/json; charset=utf8
x-api-key: {API Key}
Parameters
Optional | Type | Description | Example |
|---|---|---|---|
name | string | 검색할 tag name 문자열 해당 문자열을 포함하는 tag 정보를 반환한다. | &name=new |
limit | int | 한꺼번에 표시할 갯수 0 = no limit. (Lake 생성시 설정에 따라 0일 경우에도 제한이 발생할 수 있다.) | &limit=100 |
offset | int | 여러 페이지로 표시하기 위해 건너뛰어야 할 데이터의 수 | &offset=50 |
Request Example
GET https://aws1.us.machlake.com/lakes/xbacd1234/tags?name=new&limit=100
Content-Type: application/json; charset=utf8
x-api-key: {API Key}
Response Example
Status 200
{
"status": "success",
"data": {
"tag": [
{"name": "newtag01"},
{"name": "newtag02"}
]
}
}