Set Multiple Measurement Points Asynchronously¶
异步多点设定测点值。
请求格式¶
PUT http://{apigw-address}/dataService/devices/multiSet?orgId={}
请求参数(URI)¶
名称 |
位置 (Path/Query) |
是否必须 |
数据类型 |
描述 |
---|---|---|---|---|
orgId |
Query |
是 |
String |
资产所属的组织ID。 如何获取orgId信息>> |
请求参数(Body)¶
名称 |
是否必须 |
数据类型 |
描述 |
---|---|---|---|
data |
True |
Object |
设定测点值的相关信息。结构见下表。 |
名称 |
是否必须 |
数据类型 |
描述 |
---|---|---|---|
requestId |
True |
String |
设定测点值请求的标识符 |
orgId |
True |
String |
OU的ID |
callType |
False |
String |
调用类型,值为 |
setMeasurepointChannelId |
True |
String |
设定测点值使用的通道ID |
productKey |
True |
String |
测点所属产品的product key,用于与 |
deviceKey |
True |
String |
测点所属产品的device key,用于与 |
assetId |
True |
String |
测点所属设备资产的asset ID,用于指定一个设备资产 |
measurepointId |
True |
String |
目标测点的ID |
callbackUrl |
False |
String |
回调函数URL |
inputData |
False |
Object |
输入数据,由输入数据键值对组成 |
timeout |
False |
Long |
超时时间,单位为毫秒,默认30000,最大300000 |
gmtSetMeasurepointRequest |
False |
Long |
调用者设定的设定测点值的时间,为精确到毫秒的UNIX时间戳,如果值为空或不大于0,则取当前系统时间 |
备注
在 subscribePointList `` 对象中,优先以 ``assetId
来确定设备。如果 assetId
不存在,则以 deviceKey
+ productKey
的组合来确定设备。
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
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时间戳 |
备注
在 subscribePointList `` 对象中,优先以 ``assetId
来确定设备。如果 assetId
不存在,则以 deviceKey
+ productKey
的组合来确定设备。
输入输出示例¶
请求示例¶
PUT http://{apigw-address}/dataService/devices/multiSet?orgId=o15434988531231
{
"data":[
{
"requestId":"dfsadfdsafdsaf",
"orgId":"adadad",
"callType":"ASYNC",
"setMeasurepointChannelId":"DATASVC.SET.afdasfasdf",
"productKey":"dfasdf",
"deviceKey":"dsfa",
"assetId":"aaa",
"measurepointId":"bbb",
"callbackUrl":null,
"inputData":{
"arg":10
},
"timeout":30000,
"gmtSetMeasurepointRequest":132132465464
},
{
"requestId":"12321321321",
"orgId":"adadad",
"callType":"ASYNC",
"setMeasurepointChannelId":"DATASVC.SET.afdasfasdf",
"productKey":"dfasdf",
"deviceKey":"dsfa",
"assetId":"aaa",
"measurepointId":"ccc",
"callbackUrl":null,
"inputData":{
"arg":11
},
"timeout":30000,
"gmtSetMeasurepointRequest":132132465464
}
]
}
响应示例¶
{
"status":0,
"msg":"Success",
"submsg":null,
"data":[
{
"requestId":"testRequestId1",
"orgId":"aaa",
"callType":"ASYNC",
"setMeasurepointChannelId":"DATASVC.SET.setMeasurepointChannelId1",
"productKey":"6Bt59ySj",
"deviceKey":"zBAofs6D4s",
"assetId":"YCdyvNmc",
"measurepointId":"measurepointId1",
"callbackUrl":null,
"inputData":{
"testArg":1.0
},
"status":1000,
"msg":"para error",
"submsg":"para error",
"timeout":30000,
"gmtSetMeasurepointRequest":1536638267507,
"gmtSetMeasurepointReply":1536638267509
},
{
"requestId":"testRequestId2",
"orgId":"aaa",
"requestMethod":"thing.service.d",
"callType":"ASYNC",
"setMeasurepointChannelId":"DATASVC.SET.setMeasurepointChannelId1",
"productKey":"6Bt59ySj",
"deviceKey":"zBAofs6D4s",
"assetId":"YCdyvNmc",
"measurepointId":"measurepointId2",
"callbackUrl":null,
"inputData":{
"testArg":1.0
},
"status":1000,
"msg":"para error",
"submsg":"para error",
"timeout":30000,
"gmtSetMeasurepointRequest":1536638267507,
"gmtSetMeasurepointReply":1536638267509
}
]
}