文档首页/ IoT边缘 IoTEdge/ API参考/ API列表/ 设备控制/ 获取属性执行中的控制
更新时间:2026-09-22 GMT+08:00
分享

获取属性执行中的控制

功能介绍

获取属性执行中的控制

调试

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

URI

GET /v2/{project_id}/edge-nodes/{edge_node_id}/devices/{device_id}/active-controls

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。获取方法请参见 获取项目ID。

edge_node_id

是

String

边缘节点ID

device_id

是

String

设备ID

表2 Query参数

参数

是否必选

参数类型

描述

service_id

否

String

设备服务id。可选,在属性平铺场景不需要填,如果不填则表示service_id为空字符串

property

是

String

设备属性。必选

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。通过调用IAM服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

device_id

String

设备id

service_id

String

设备的服务id

property

String

设备的属性

active_controls

Array of ActiveControlRspDTO objects

正在执行中的控制列表

result_code

Integer

结果响应码,大于等于400表示失败,小于400表示成功

result_desc

String

结果描述

表5 ActiveControlRspDTO

参数

参数类型

描述

control_type

String

控制类型,包括control、schedule、local_control

control_id

String

控制id

priority

Integer

控制的优先级

value

Object

此次控制的值

end_time

Long

控制的结束时间

create_time

Long

记录创建的时间

请求示例

无

响应示例

状态码:200

{
  "device_id" : "dev1",
  "service_id" : "service1",
  "property" : "property1",
  "active_controls" : [ {
    "control_type" : "control",
    "control_id" : "11111",
    "value" : 10,
    "priority" : 8,
    "end_time" : 1730865304000,
    "create_time" : 1730865303000
  } ],
  "result_code" : 0,
  "result_desc" : ""
}

状态码

状态码

描述

200

OK

401

Bad Request

500

Internal Server Error

错误码

请参见错误码。

相关文档