DigitalTwinAdapterInboundRoute¶
- class oci.iot.models.DigitalTwinAdapterInboundRoute(**kwargs)¶
Bases:
objectDefines how inbound device payloads should be routed and mapped within a digital twin context. Routes are evaluated in the order they are defined, and only the first matching condition is processed. A final default route (with a condition that always evaluates to true) is recommended for fallback handling.
Methods:
__init__(**kwargs)Initializes a new DigitalTwinAdapterInboundRoute object with values from keyword arguments.
Attributes:
[Required] Gets the condition of this DigitalTwinAdapterInboundRoute.
Gets the content_root of this DigitalTwinAdapterInboundRoute.
Gets the description of this DigitalTwinAdapterInboundRoute.
Gets the payload_mapping of this DigitalTwinAdapterInboundRoute.
Gets the reference_payload of this DigitalTwinAdapterInboundRoute.
Gets the target of this DigitalTwinAdapterInboundRoute.
- __init__(**kwargs)¶
Initializes a new DigitalTwinAdapterInboundRoute object with values from keyword arguments. The following keyword arguments are supported (corresponding to the getters/setters of this class):
- Parameters
condition (str) – The value to assign to the condition property of this DigitalTwinAdapterInboundRoute.
reference_payload (oci.iot.models.DigitalTwinAdapterPayload) – The value to assign to the reference_payload property of this DigitalTwinAdapterInboundRoute.
target (str) – The value to assign to the target property of this DigitalTwinAdapterInboundRoute.
content_root (str) – The value to assign to the content_root property of this DigitalTwinAdapterInboundRoute.
payload_mapping (dict(str, str)) – The value to assign to the payload_mapping property of this DigitalTwinAdapterInboundRoute.
description (str) – The value to assign to the description property of this DigitalTwinAdapterInboundRoute.
- property condition¶
[Required] Gets the condition of this DigitalTwinAdapterInboundRoute. A boolean expression used to determine whether the following transformation should be processed for the incoming payload. This expression is typically based on fields defined at the inbound Envelope and is evaluated before applying the payloadMapping.
- Returns
The condition of this DigitalTwinAdapterInboundRoute.
- Return type
str
- property content_root¶
Gets the content_root of this DigitalTwinAdapterInboundRoute. JSON Path string to override the context root before delegating to the adapter of the target digital twin instance.
- Returns
The content_root of this DigitalTwinAdapterInboundRoute.
- Return type
str
- property description¶
Gets the description of this DigitalTwinAdapterInboundRoute. Meaningful write up about the inbound route.
- Returns
The description of this DigitalTwinAdapterInboundRoute.
- Return type
str
- property payload_mapping¶
Gets the payload_mapping of this DigitalTwinAdapterInboundRoute. A set of key-value JQ expressions used to transform the incoming payload into a shape compatible with the digital twin model’s context or schema.
The keys are target fields (in the digital twin model), and values are JQ expressions pointing to data in the reference payload.
Example: Given payload: {
“time”: “<timestamp>”, “temp”: 65, “hum”: 55
} And mapping: {
“temperature”: “$.temp”, “humidity”: “$.hum”, “timeObserved”: “$.time”
} The output will be: {
“temperature”: 65, “humidity”: 55, “timeObserved”: “<timestamp>”
}
- Returns
The payload_mapping of this DigitalTwinAdapterInboundRoute.
- Return type
dict(str, str)
- property reference_payload¶
Gets the reference_payload of this DigitalTwinAdapterInboundRoute.
- Returns
The reference_payload of this DigitalTwinAdapterInboundRoute.
- Return type
- property target¶
Gets the target of this DigitalTwinAdapterInboundRoute. Optional. JQ expression to map the target resource, which is externalKey of digital twin instance, the incoming data belongs to.
- Returns
The target of this DigitalTwinAdapterInboundRoute.
- Return type
str