View a Measure Threshold by Measure
get
/primeapi/restapi/measureThreshold/measure/{measureId}
This endpoint returns measure thresholds that meet the following requirements:
- The object is associated with a measure with an ID value that matches the value of the {measureId} path parameter.
Request
Path Parameters
-
measureId: integer(int64)
The system-generated identifier of a measure.
Response
Supported Media Types
- application/json
200 Response
successful operation
Nested Schema : ApiEntityMeasureThreshold
Type:
Show Source
object
-
computeAgainstType(optional):
string
Allowed Values:
[ "ACTUAL_VALUE", "PERCENT_OF_TARGET" ]
The against type of a threshold. -
desirableState(optional):
string
Allowed Values:
[ "HIGH_VALUES", "LOW_VALUES" ]
The type of direction of a threshold. -
link(optional):
string(url)
Read Only:
true
-
measureId(optional):
integer(int64)
The unique identifier of a measure.
-
measureThresholdItems(optional):
array measureThresholdItems
Unique Items Required:
true
-
thresholdId(optional):
integer(int64)
The unique identifier of a threshold.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityMeasureThresholdItem
Type:
Show Source
object
-
color(optional):
string
The color representation of the threshold state.
-
icon(optional):
string
Allowed Values:
[ "THREE_D", "CHECK", "CIRCLE", "CONTENT", "CORRECT", "DIAMOND", "ERROR", "EXCLAMATION", "FLAG", "HAPPY", "OK", "POP_UP", "SAD", "SQUARE", "STAR", "TARGET", "TRIANGLE", "WARNING", "X" ]
The pictorial representation of the threshold state. -
link(optional):
string(url)
Read Only:
true
-
measureThresholdId(optional):
integer(int64)
The unique identifier of a threshold.
-
operator(optional):
string
Allowed Values:
[ "EQUALS", "GREATER_THAN", "GREATER_THAN_EQUALS", "LESS_THAN_EQUALS", "NOT_EQUALS", "LESS_THAN", "BETWEEN", "NOT_BETWEEN" ]
The logical operator for the threshold used for measuring values. -
targetHighValue(optional):
number(double)
High Value enables you to set a maximum value other threshold values can be measured against.
The High Value is only editable if Value is selected and the threshold operator is set to "within range" or "not within range". -
targetValue(optional):
number(double)
The measurement used for the threshold range.
-
thresholdItemId(optional):
integer(int64)
The unique identifier of a threshold item.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
204 Response
Successful operation with no content.
404 Response
The requested measure threshold does not exist, or you do not have access to it.