同步设点¶

通过Asset ID来设定测点值。

请求格式¶

POST 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	Object	按照模型点数据类型定义模型点类型为 String 时填字符串模型点类型为 Double 时填数字

响应参数¶

响应参数¶
名称	数据类型	描述
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
    }
}