文档首页/ IoT数据分析 IoTA/ API参考/ API列表/ 存储标签查询/ 查询标签的值列表
更新时间：2022-07-13 GMT+08:00
查看PDF
分享

查询标签的值列表

功能介绍

查询标签的值列表

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

GET /v1/{project_id}/data-stores/{data_store_id}/tags/{tag_name}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

最小长度：1

最大长度：128

data_store_id

是

String

存储ID

最小长度：1

最大长度：64

tag_name

是

String

tag 名称，例如：deviceId

最小长度：1

最大长度：64
表2 Query参数

参数

是否必选

参数类型

描述

filters

否

String

查询标签的值的过滤条件，例如: {"deviceCategory": "class1"}，注意特殊字符需要 urlencode

最小长度：0

最大长度：1024

offset

否

Integer

查询起始元素的偏移

最小值：0

最大值：2000

缺省值：0

limit

否

Integer

返回的元素列表大小限制,默认为 100

最小值：1

最大值：2000

缺省值：100

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

租户Token

最小长度：1

最大长度：65535

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

tag_name

String

标签的名称

最小长度：1

最大长度：64

tag_values

Array of strings

标签的值列表

count

Integer

当前列表元素总数

最小值：0

最大值：2000

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

error_msg

String

错误消息

状态码： 401

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

error_msg

String

错误消息

状态码： 403

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

error_msg

String

错误消息

状态码： 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

error_msg

String

错误消息

请求示例

无

响应示例

状态码： 200

OK

{
  "tag_name" : "deviceId",
  "tag_values" : [ "device_1", "device_2", "device_3" ],
  "count" : 3
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

500

Internal Server Error

错误码

请参见错误码。

父主题： 存储标签查询

相关文档