Set Multiple Measurement Points Asynchronously

异步多点设定测点值。

请求格式

PUT http://{apigw-address}/dataService/devices/multiSet?orgId={}

请求参数(URI)

请求参数 (URI)

名称

位置 (Path/Query)

是否必须

数据类型

描述

orgId

Query

String

资产所属的组织ID。 如何获取orgId信息>>

请求参数(Body)

请求参数 (Body)

名称

是否必须

数据类型

描述

data

True

Object

设定测点值的相关信息。结构见下表。

data结构

名称

是否必须

数据类型

描述

requestId

True

String

设定测点值请求的标识符

orgId

True

String

OU的ID

callType

False

String

调用类型,值为 ASYNC ,表示异步

setMeasurepointChannelId

True

String

设定测点值使用的通道ID

productKey

True

String

测点所属产品的product key,用于与 deviceKey 一起使用以指定一个设备资产

deviceKey

True

String

测点所属产品的device key,用于与 productKey 一起使用以指定一个设备资产

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

调用类型, 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时间戳

备注

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
      }
   ]
}