Queries ValidFrom and ValidUntil (timely validity)
The queries ValidFrom and ValidUntil allow the
output of only those resources that are valid in the period defined by them. This means that
all resources are found whose ValidFrom is less than or equal to the
ValidFrom specified here, and whose ValidUntil is
greater than or equal to the ValidUntil specified here.
These queries do not apply for the resources /Agents, /Processes/terminated, /Processes/active and /Processes/all.
Without these queries, the current time is always selected internally for
validFrom in GET, as well as
9999-99-99-99.99.99.999999 for validUntil. This means that only the
entries that are valid at the current time of the method call are output.
Example:
curl -H "@auth" -iX GET
"http://192.168.0.26:8080/Processes/defined?ValidFrom=2023-05-11-22.59.59.000000&ValidUntil=2030-05-11-22.59.59.000000"
ValidFrom must be ≤ ValidUntil, otherwise the
following error message is the output:
HTTP/1.1 400 Bad Request
{"ERROR": "Invalid time frame: Query ValidFrom > Query ValidUntil"}