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)

请求参数 (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)

请求参数 (Body)

名称

是否必须

数据类型

描述

value

True

Map

需要写的数据值

响应参数

响应参数

名称

数据类型

描述

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 的组合来确定设备。

输入输出示例

请求示例

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