Set Measurement Points By Asset ID¶
通过Asset ID来设定测点值
请求格式¶
PUT http://{apigw-address}/edge-service/v1/commands?action=setMeasurepointByAssetId&assetId={}&measurepointId={}&orgId={}&timeout={}&requestId={}&transferWay={}
请求参数(URI)¶
名称 |
位置 (Path/Query) |
是否必须 |
数据类型 |
描述 |
---|---|---|---|---|
orgId |
Query |
是 |
String |
资产所属的组织ID。 如何获取orgId信息>> |
action |
Query |
是 |
String |
setMeasurepointByAssetId |
measurepointId |
Query |
是 |
String |
Measurepoint ID |
assetId |
Query |
是 |
String |
资产的ID |
timeout |
Query |
否 |
Long |
Service timeout ,单位毫秒,默认为30000,最大不能超过300000 |
requestId |
Query |
是 |
String |
请求ID |
callbackUrl |
Query |
否 |
String |
Callback URL |
gmtSetMeasurepointRequest |
Query |
否 |
Long |
调用者设定的写值时间,从1970-01-01 00:00:00开始的毫秒数,如果不填或<=0,则取当前系统时间 |
transferWay |
Query |
否 |
Integer |
0表示数据实时上送,1表示数据变化上送,默认值为0 |
请求参数(Body)¶
名称 |
是否必须 |
数据类型 |
描述 |
---|---|---|---|
value |
True |
Map |
需要写的数据值 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
status |
Int |
响应状态码 |
msg |
String |
返回消息,用于描述响应结果 |
submsg |
String |
返回子消息,用于描述响应结果 |
data |
Object |
响应数据object,结构见下表 |
名称 |
数据类型 |
描述 |
---|---|---|
requestId |
String |
设定测点值请求的标识符 |
orgId |
String |
OU的ID |
callType |
String |
调用类型, |
setMeasurepointChannelId |
String |
写入测点使用的通道ID |
productKey |
String |
测点所属产品的product key,用于与 |
deviceKey |
String |
测点所属产品的device key,用于与 |
assetId |
String |
测点所属设备资产的asset ID,用于指定一个设备资产 |
measurepointId |
String |
目标测点的ID |
callbackUrl |
String |
回调函数URL |
inputData |
Object |
输入数据,由输入数据键值对组成 |
status |
Int |
设定测点的结果,0表示成功,其他值表示失败 |
msg |
String |
返回消息,对 |
submsg |
String |
返回子消息,对 |
timeout |
Long |
超时时间 |
gmtSetMeasurepointRequest |
Long |
设定测点值的时间,精确到毫秒的UNIX时间戳 |
gmtSetMeasurepointReply |
Long |
服务响应时间,精确到毫秒的UNIX时间戳 |
transferWay |
Integer |
0表示数据实时上送,1表示数据变化上送,默认值为0 |
备注
在 subscribePointList `` 对象中,优先以 ``assetId
来确定设备。如果 assetId
不存在,则以 deviceKey
+ productKey
的组合来确定设备。
输入输出示例¶
请求示例¶
PUT http://{apigw-address}/edge-service/v1/commands?action=setMeasurepointByAssetId&assetId={}&measurepointId={}&orgId={}&timeout={}&requestId={}&transferWay={}
{
"arg":10
}
响应示例¶
{
"status":0,
"msg":"Success",
"submsg":null,
"data":{
"requestId":"testRequestId",
"orgId":"aaa",
"callType":"SYNC",
"setMeasurepointChannelId":"DATASVC.SET.setMeasurepointChannelId1",
"productKey":"6Bt59ySj",
"deviceKey":"zBAofs6D4s",
"assetId":"YCdyvNmc",
"measurepointId":"measurepointId1",
"callbackUrl":null,
"inputData":{
"testArg":1.0
},
"status":0,
"msg":"SUCCESS",
"submsg":null,
"timeout":30000,
"gmtSetMeasurepointRequest":1536638267507,
"gmtSetMeasurepointReply":1536638267509,
"transferWay":0
}
}