同步设点¶
通过Asset ID来设定测点值。
请求格式¶
POST 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 |
响应参数¶
名称 | 数据类型 | 描述 |
---|---|---|
status | Int | 响应状态码 |
msg | String | 返回消息,用于描述响应结果 |
submsg | String | 返回子消息,用于描述响应结果 |
data | Object | 响应数据object,结构见下表 |
名称 | 数据类型 | 描述 |
---|---|---|
requestId | String | 设定测点值请求的标识符 |
orgId | String | OU的ID |
callType | String | 调用类型, SYNC 表示同步, ASYNC 表示异步 |
setMeasurepointChannelId | String | 写入测点使用的通道ID |
productKey | String | 测点所属产品的product key,用于与 deviceKey 一起使用以指定一个设备资产 |
deviceKey | String | 测点所属产品的device key,用于与 productKey 一起使用以指定一个设备资产 |
assetId | String | 测点所属设备资产的asset ID,用于指定一个设备资产 |
measurepointId | String | 目标测点的ID |
callbackUrl | String | 回调函数URL |
inputData | Object | 输入数据,由输入数据键值对组成 |
status | Int | 设定测点的结果,0表示成功,其他值表示失败 |
msg | String | 返回消息,对 status 的描述 |
submsg | String | 返回子消息,对 status 的描述 |
timeout | Long | 超时时间 |
gmtSetMeasurepointRequest | Long | 设定测点值的时间,精确到毫秒的UNIX时间戳 |
gmtSetMeasurepointReply | Long | 服务响应时间,精确到毫秒的UNIX时间戳 |
transferWay | Integer | 0表示数据实时上送,1表示数据变化上送,默认值为0 |
注解
在 subscribePointList `` 对象中,优先以 ``assetId
来确定设备。如果 assetId
不存在,则以 deviceKey
+ productKey
的组合来确定设备。
输入输出示例¶
请求示例¶
POST http://{apigw-address}/edge-service/v1/commands?action=setMeasurepointByAssetId&assetId={}&measurepointId={}&orgId={}&timeout={}&requestId={}&transferWay={}
{
"value":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
}
}