Servicios de cosa remota
A continuación, se muestra la lista de servicios que se pueden utilizar con cosas remotas.
Servicio
Descripción
EvaluateReporting
Este servicio evalúa el estado de informes de la cosa en función de su estrategia.
A continuación se indican los parámetros de entrada del servicio:
eventName: nombre del evento
eventTime: hora a la que se activa el evento
source: nombre de la cosa que activa los eventos
sourceProperty: objeto eventData de la propiedad de origen
No se recibe ninguna salida después de ejecutar este servicio.
GetEventSubscriptions
Obtenga los eventos que están enlazados a la cosa remota.
No se requiere ninguna entrada para este servicio.
Al ejecutarse este servicio, se devuelven los eventos suscritos para la cosa remota en forma de infotable.
Tras ejecutar este servicio se reciben los siguientes parámetros:
Data Shape: EdgeThingEventNotification
Infotable Type: solo infotable
GetPropertySubscriptions
Obtenga las propiedades, además del tipo de cambio de datos y el umbral de cambio de datos para la cosa de periferia.
A continuación se indican los parámetros de entrada del servicio:
options: opciones de enlace que soporta el SDK de llamada
Al ejecutarse este servicio, se devuelven las propiedades suscritas para la cosa remota en forma de infotable.
Tras ejecutar este servicio se reciben los siguientes parámetros:
Data Shape: EdgeThingEventNotification
Infotable Type: solo infotable
GetQueuedTasks
Recupere cualquier tarea de esta cosa conectada.
No se requiere ninguna entrada para este servicio.
Al ejecutarse este servicio, se devuelven las cosas de periferia en forma de infotable.
Tras ejecutar este servicio se reciben los siguientes parámetros:
Data Shape: MessageStoreList
Infotable Type: solo infotable
GetRemoteMetadata
Se devuelven los metadatos de la cosa conectada.
No se requiere ninguna entrada para este servicio.
Al ejecutarse este servicio, se devuelven los metadatos de cosa conectada en formato JSON.
GetReportingStrategy
Se recupera la estrategia de informes de esta cosa.
No se requiere ninguna entrada para este servicio.
Al ejecutarse este servicio, se devuelven los metadatos de cosa conectada en formato STRING.
Invoke
A continuación se indican los parámetros de entrada del servicio:
endpointUri
paramsTable
headerParams
resultType
Al ejecutarse este servicio, se devuelve la salida en forma de infotable.
ProcessRemoteEvents
Procesar eventos remotos.
A continuación se indican los parámetros de entrada del servicio:
values
No se recibe ninguna salida después de ejecutar este servicio.
ReceiveRouteLifecycleEvent
A continuación se indican los parámetros de entrada del servicio:
eventPayload
No se recibe ninguna salida después de ejecutar este servicio.
RegisterRoute
A continuación se indican los parámetros de entrada del servicio:
routeXml
No se recibe ninguna salida después de ejecutar este servicio.
SendMaxQueuedTasks
Permite enviar hasta un número máximo específico de tareas en cola a la cosa conectada.
A continuación se indican los parámetros de entrada del servicio:
maxCount: número máximo de mensajes deseados por el dispositivo Edge.
Al ejecutarse este servicio, se devuelve el número de tareas en cola enviadas, hasta maxCount, en formato INTEGER.
SendQueuedTasks
Permite enviar las tareas que se han colado a la cosa conectada.
No se requiere ninguna entrada para este servicio.
No se recibe ninguna salida después de ejecutar este servicio.
SetReportingStrategy
Defina la estrategia de informes de esta cosa.
A continuación se indican los parámetros de entrada del servicio:
strategyThing: nombre de la cosa de estrategia.
No se recibe ninguna salida después de ejecutar este servicio.
UpdateSubscribedPropertyValues
Escriba valores de propiedad suscritos para una cosa conectada.
A continuación se indican los parámetros de entrada para el servicio:
values
No se recibe ninguna salida después de ejecutar este servicio.
El parámetro values es una infotable que consta de múltiples filas, donde en cada fila se incluyen el nombre de propiedad, el valor y la calidad junto con la fecha y hora de actualización. Los valores de la propiedad no se pueden definir en nulo.
Por defecto, las actualizaciones de valores se realizan para cada propiedad por separado. Para clasificar y agrupar los valores por fecha y hora en lugar de por propiedad, la configuración GroupPropertyValuesByTime se debe definir en verdadero en la sección BasicSettings de platform-settings.json.
Cuando la configuración anterior se define en verdadero, las alertas y los eventos activados por datos de todas las propiedades actualizadas con la misma fecha y hora se lanzan juntos. Como resultado, las suscripciones multievento registradas para algunos o todos estos eventos solo se ejecutarán una vez por fecha y hora, y los eventos coincidentes se pasarán en el parámetro events.
UpdateSubscribedPropertyValuesBatched
Escriba valores de propiedad suscritos en lotes para una cosa conectada.
A continuación se indican los parámetros de entrada para el servicio:
batches
No se recibe ninguna salida después de ejecutar este servicio.
El parámetro batches es una infotable que consta de múltiples filas. En cada fila se incluye un lote de valores de propiedades y la fecha y hora de actualización.
El valor del campo batch es una infotable que consta de múltiples filas. En cada fila se incluyen el nombre, el valor y la calidad de la propiedad. Los valores de la propiedad no se pueden definir en nulo.
Los valores de las propiedades se clasifican y agrupan por marcas de fecha y hora de los lotes, lo que significa que los eventos y las alertas activados por datos de todas las propiedades actualizadas con la misma fecha y hora se lanzan juntos. Como resultado, las suscripciones multievento registradas para algunos o todos estos eventos solo se ejecutarán una vez por fecha y hora, y todos los eventos coincidentes se pasarán en el parámetro events.
¿Fue esto útil?