远程事物服务
以下是可与远程事物一起使用的服务的列表。
服务
说明
EvaluateReporting
此服务会根据事物策略评估其报告状态。
以下是服务的输入参数:
eventName:事件的名称
eventTime:触发事件的时间
source:触发事件的事物的名称
sourceProperty:源属性 eventData
执行此服务后不会收到任何输出。
GetEventSubscriptions
获取绑定到远程事物的事件。
此服务不需要任何输入。
执行此服务会以信息表形式返回远程事物的订阅事件。
执行此服务后会收到下列参数:
Data Shape:EdgeThingEventNotification
Infotable Type:仅信息表
GetPropertySubscriptions
获取 Edge 事物的属性以及数据更改类型和数据更改阈值。
以下是服务的输入参数:
options:调用 SDK 所支持的绑定选项
执行此服务会以信息表形式返回远程事物的订阅属性。
执行此服务后会收到下列参数:
Data Shape:EdgeThingEventNotification
Infotable Type:仅信息表
GetQueuedTasks
检索此连接事物的所有任务。
此服务不需要任何输入。
执行此服务会以信息表形式返回 Edge 事物。
执行此服务后会收到下列参数:
Data Shape:MessageStoreList
Infotable Type:仅信息表
GetRemoteMetadata
返回连接的事物的元数据。
此服务不需要任何输入。
执行此服务会以 JSON 格式返回“连接的事物”元数据。
GetReportingStrategy
检索此事物的报告策略。
此服务不需要任何输入。
执行此服务会以 STRING 格式返回“连接的事物”元数据。
Invoke
以下是服务的输入参数:
endpointUri
paramsTable
headerParams
resultType
执行此服务会以信息表形式返回输出。
ProcessRemoteEvents
处理远程事件。
以下是服务的输入参数:
values
执行此服务后不会收到任何输出。
ReceiveRouteLifecycleEvent
以下是服务的输入参数:
eventPayload
执行此服务后不会收到任何输出。
RegisterRoute
以下是服务的输入参数:
routeXml
执行此服务后不会收到任何输出。
SendMaxQueuedTasks
向连接的事物发送特定最大数量的队列任务。
以下是服务的输入参数:
maxCount:Edge 设备所需消息数的最大值。
执行此服务会以 INTEGER 格式返回已发送的队列任务数,最大为 maxCount。
SendQueuedTasks
将任何已排队的任务发送到连接的事物。
此服务不需要任何输入。
执行此服务后不会收到任何输出。
SetReportingStrategy
设置此事物的报告策略。
以下是服务的输入参数:
strategyThing:策略事物的名称。
执行此服务后不会收到任何输出。
UpdateSubscribedPropertyValues
写入连接事物的已订阅属性值。
以下为该服务的输入参数:
values
执行此服务后不会收到任何输出。
参数 values 是一个由多个行组成的信息表,每一行都包含属性名称、值和质量,并带有更新时间戳。属性值不能设置为空。
默认情况下,会分别更新每个属性的值。要按时间戳而非属性对值进行排序和分组,应在 platform-settings.jsonBasicSettings 部分将 GroupPropertyValuesByTime 设置设定为 true
将上述设置设定为 true 后,所有以相同时间戳更新的属性,其数据触发事件和警报将同时触发。因此,为部分或全部上述事件注册的多事件订阅将仅针对每个时间戳执行一次,且会在 events 参数中传递匹配事件。
UpdateSubscribedPropertyValuesBatched
批量写入连接事物的已订阅属性值。
以下为该服务的输入参数:
batches
执行此服务后不会收到任何输出。
batches 参数是由多个行组成的信息表。每一行都包含一批属性值和更新时间戳。
batch 字段值为由多个行组成的信息表。每一行都包含属性名称、值和质量。属性值不能设置为空。
属性值按照批次的时间戳进行排序和分组,这意味着所有以相同时间戳更新的属性,其数据触发事件和警报将同时触发。因此,为部分或全部上述事件注册的多事件订阅将仅针对每个时间戳执行一次,且会在事件参数中传递所有匹配事件。
这对您有帮助吗?