1*f2a8e57eSGunnar Mills{ 2*f2a8e57eSGunnar Mills "$id": "http://redfish.dmtf.org/schemas/v1/Triggers.v1_4_0.json", 3*f2a8e57eSGunnar Mills "$ref": "#/definitions/Triggers", 4*f2a8e57eSGunnar Mills "$schema": "http://redfish.dmtf.org/schemas/v1/redfish-schema-v1.json", 5*f2a8e57eSGunnar Mills "copyright": "Copyright 2014-2024 DMTF. For the full DMTF copyright policy, see http://www.dmtf.org/about/policies/copyright", 6*f2a8e57eSGunnar Mills "definitions": { 7*f2a8e57eSGunnar Mills "Actions": { 8*f2a8e57eSGunnar Mills "additionalProperties": false, 9*f2a8e57eSGunnar Mills "description": "The available actions for this resource.", 10*f2a8e57eSGunnar Mills "longDescription": "This type shall contain the available actions for this resource.", 11*f2a8e57eSGunnar Mills "patternProperties": { 12*f2a8e57eSGunnar Mills "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 13*f2a8e57eSGunnar Mills "description": "This property shall specify a valid odata or Redfish property.", 14*f2a8e57eSGunnar Mills "type": [ 15*f2a8e57eSGunnar Mills "array", 16*f2a8e57eSGunnar Mills "boolean", 17*f2a8e57eSGunnar Mills "integer", 18*f2a8e57eSGunnar Mills "number", 19*f2a8e57eSGunnar Mills "null", 20*f2a8e57eSGunnar Mills "object", 21*f2a8e57eSGunnar Mills "string" 22*f2a8e57eSGunnar Mills ] 23*f2a8e57eSGunnar Mills } 24*f2a8e57eSGunnar Mills }, 25*f2a8e57eSGunnar Mills "properties": { 26*f2a8e57eSGunnar Mills "Oem": { 27*f2a8e57eSGunnar Mills "$ref": "#/definitions/OemActions", 28*f2a8e57eSGunnar Mills "description": "The available OEM-specific actions for this resource.", 29*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the available OEM-specific actions for this resource." 30*f2a8e57eSGunnar Mills } 31*f2a8e57eSGunnar Mills }, 32*f2a8e57eSGunnar Mills "type": "object" 33*f2a8e57eSGunnar Mills }, 34*f2a8e57eSGunnar Mills "DirectionOfCrossingEnum": { 35*f2a8e57eSGunnar Mills "description": "The direction of crossing that corresponds to a trigger.", 36*f2a8e57eSGunnar Mills "enum": [ 37*f2a8e57eSGunnar Mills "Increasing", 38*f2a8e57eSGunnar Mills "Decreasing" 39*f2a8e57eSGunnar Mills ], 40*f2a8e57eSGunnar Mills "enumDescriptions": { 41*f2a8e57eSGunnar Mills "Decreasing": "A trigger is met when the metric value crosses the trigger value while decreasing.", 42*f2a8e57eSGunnar Mills "Increasing": "A trigger condition is met when the metric value crosses the trigger value while increasing." 43*f2a8e57eSGunnar Mills }, 44*f2a8e57eSGunnar Mills "longDescription": "The value shall indicate the direction of crossing that corresponds to a trigger.", 45*f2a8e57eSGunnar Mills "type": "string" 46*f2a8e57eSGunnar Mills }, 47*f2a8e57eSGunnar Mills "DiscreteTrigger": { 48*f2a8e57eSGunnar Mills "additionalProperties": false, 49*f2a8e57eSGunnar Mills "description": "The characteristics of the discrete trigger.", 50*f2a8e57eSGunnar Mills "longDescription": "This object shall contain the characteristics of the discrete trigger.", 51*f2a8e57eSGunnar Mills "patternProperties": { 52*f2a8e57eSGunnar Mills "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 53*f2a8e57eSGunnar Mills "description": "This property shall specify a valid odata or Redfish property.", 54*f2a8e57eSGunnar Mills "type": [ 55*f2a8e57eSGunnar Mills "array", 56*f2a8e57eSGunnar Mills "boolean", 57*f2a8e57eSGunnar Mills "integer", 58*f2a8e57eSGunnar Mills "number", 59*f2a8e57eSGunnar Mills "null", 60*f2a8e57eSGunnar Mills "object", 61*f2a8e57eSGunnar Mills "string" 62*f2a8e57eSGunnar Mills ] 63*f2a8e57eSGunnar Mills } 64*f2a8e57eSGunnar Mills }, 65*f2a8e57eSGunnar Mills "properties": { 66*f2a8e57eSGunnar Mills "DwellTime": { 67*f2a8e57eSGunnar Mills "description": "The amount of time that a trigger event persists before the metric action is performed.", 68*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the amount of time that a trigger event persists before the `TriggerActions` are performed.", 69*f2a8e57eSGunnar Mills "pattern": "^P(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+(.\\d+)?S)?)?$", 70*f2a8e57eSGunnar Mills "readonly": false, 71*f2a8e57eSGunnar Mills "type": [ 72*f2a8e57eSGunnar Mills "string", 73*f2a8e57eSGunnar Mills "null" 74*f2a8e57eSGunnar Mills ] 75*f2a8e57eSGunnar Mills }, 76*f2a8e57eSGunnar Mills "Name": { 77*f2a8e57eSGunnar Mills "description": "The name of the trigger.", 78*f2a8e57eSGunnar Mills "longDescription": "This property shall contain a name for the trigger.", 79*f2a8e57eSGunnar Mills "readonly": true, 80*f2a8e57eSGunnar Mills "type": [ 81*f2a8e57eSGunnar Mills "string", 82*f2a8e57eSGunnar Mills "null" 83*f2a8e57eSGunnar Mills ] 84*f2a8e57eSGunnar Mills }, 85*f2a8e57eSGunnar Mills "Severity": { 86*f2a8e57eSGunnar Mills "anyOf": [ 87*f2a8e57eSGunnar Mills { 88*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Health" 89*f2a8e57eSGunnar Mills }, 90*f2a8e57eSGunnar Mills { 91*f2a8e57eSGunnar Mills "type": "null" 92*f2a8e57eSGunnar Mills } 93*f2a8e57eSGunnar Mills ], 94*f2a8e57eSGunnar Mills "description": "The severity of the event message.", 95*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the `Severity` property to be used in the event message.", 96*f2a8e57eSGunnar Mills "readonly": false 97*f2a8e57eSGunnar Mills }, 98*f2a8e57eSGunnar Mills "Value": { 99*f2a8e57eSGunnar Mills "description": "The discrete metric value that constitutes a trigger event.", 100*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the value discrete metric that constitutes a trigger event. The `DwellTime` shall be measured from this point in time.", 101*f2a8e57eSGunnar Mills "readonly": false, 102*f2a8e57eSGunnar Mills "type": [ 103*f2a8e57eSGunnar Mills "string", 104*f2a8e57eSGunnar Mills "null" 105*f2a8e57eSGunnar Mills ] 106*f2a8e57eSGunnar Mills } 107*f2a8e57eSGunnar Mills }, 108*f2a8e57eSGunnar Mills "type": "object" 109*f2a8e57eSGunnar Mills }, 110*f2a8e57eSGunnar Mills "DiscreteTriggerConditionEnum": { 111*f2a8e57eSGunnar Mills "description": "The condition, in relationship to the discrete trigger values, which constitutes a trigger.", 112*f2a8e57eSGunnar Mills "enum": [ 113*f2a8e57eSGunnar Mills "Specified", 114*f2a8e57eSGunnar Mills "Changed" 115*f2a8e57eSGunnar Mills ], 116*f2a8e57eSGunnar Mills "enumDescriptions": { 117*f2a8e57eSGunnar Mills "Changed": "A discrete trigger condition is met whenever the metric value changes.", 118*f2a8e57eSGunnar Mills "Specified": "A discrete trigger condition is met when the metric value becomes one of the values that the `DiscreteTriggers` property lists." 119*f2a8e57eSGunnar Mills }, 120*f2a8e57eSGunnar Mills "longDescription": "This type shall specify the condition, in relationship to the discrete trigger values, which constitutes a trigger.", 121*f2a8e57eSGunnar Mills "type": "string" 122*f2a8e57eSGunnar Mills }, 123*f2a8e57eSGunnar Mills "Links": { 124*f2a8e57eSGunnar Mills "additionalProperties": false, 125*f2a8e57eSGunnar Mills "description": "The links to other resources that are related to this resource.", 126*f2a8e57eSGunnar Mills "longDescription": "This Redfish Specification-described type shall contain links to resources that are related to but are not contained by, or subordinate to, this resource.", 127*f2a8e57eSGunnar Mills "patternProperties": { 128*f2a8e57eSGunnar Mills "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 129*f2a8e57eSGunnar Mills "description": "This property shall specify a valid odata or Redfish property.", 130*f2a8e57eSGunnar Mills "type": [ 131*f2a8e57eSGunnar Mills "array", 132*f2a8e57eSGunnar Mills "boolean", 133*f2a8e57eSGunnar Mills "integer", 134*f2a8e57eSGunnar Mills "number", 135*f2a8e57eSGunnar Mills "null", 136*f2a8e57eSGunnar Mills "object", 137*f2a8e57eSGunnar Mills "string" 138*f2a8e57eSGunnar Mills ] 139*f2a8e57eSGunnar Mills } 140*f2a8e57eSGunnar Mills }, 141*f2a8e57eSGunnar Mills "properties": { 142*f2a8e57eSGunnar Mills "MetricReportDefinitions": { 143*f2a8e57eSGunnar Mills "description": "The metric report definitions that generate new metric reports when a trigger condition is met and when the `TriggerActions` property contains `RedfishMetricReport`.", 144*f2a8e57eSGunnar Mills "items": { 145*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/MetricReportDefinition.json#/definitions/MetricReportDefinition" 146*f2a8e57eSGunnar Mills }, 147*f2a8e57eSGunnar Mills "longDescription": "This property shall contain a set of links to metric report definitions that generate new metric reports when a trigger condition is met and when the `TriggerActions` property contains `RedfishMetricReport`.", 148*f2a8e57eSGunnar Mills "readonly": false, 149*f2a8e57eSGunnar Mills "type": "array", 150*f2a8e57eSGunnar Mills "versionAdded": "v1_1_0" 151*f2a8e57eSGunnar Mills }, 152*f2a8e57eSGunnar Mills "MetricReportDefinitions@odata.count": { 153*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count" 154*f2a8e57eSGunnar Mills }, 155*f2a8e57eSGunnar Mills "Oem": { 156*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem", 157*f2a8e57eSGunnar Mills "description": "The OEM extension property.", 158*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the OEM extensions. All values for properties contained in this object shall conform to the Redfish Specification-described requirements." 159*f2a8e57eSGunnar Mills } 160*f2a8e57eSGunnar Mills }, 161*f2a8e57eSGunnar Mills "type": "object" 162*f2a8e57eSGunnar Mills }, 163*f2a8e57eSGunnar Mills "MetricTypeEnum": { 164*f2a8e57eSGunnar Mills "description": "The type of metric for which the trigger is configured.", 165*f2a8e57eSGunnar Mills "enum": [ 166*f2a8e57eSGunnar Mills "Numeric", 167*f2a8e57eSGunnar Mills "Discrete" 168*f2a8e57eSGunnar Mills ], 169*f2a8e57eSGunnar Mills "enumDescriptions": { 170*f2a8e57eSGunnar Mills "Discrete": "A discrete value trigger.", 171*f2a8e57eSGunnar Mills "Numeric": "A numeric value trigger." 172*f2a8e57eSGunnar Mills }, 173*f2a8e57eSGunnar Mills "longDescription": "This type shall specify the type of metric for which the trigger is configured.", 174*f2a8e57eSGunnar Mills "type": "string" 175*f2a8e57eSGunnar Mills }, 176*f2a8e57eSGunnar Mills "OemActions": { 177*f2a8e57eSGunnar Mills "additionalProperties": true, 178*f2a8e57eSGunnar Mills "description": "The available OEM-specific actions for this resource.", 179*f2a8e57eSGunnar Mills "longDescription": "This type shall contain the available OEM-specific actions for this resource.", 180*f2a8e57eSGunnar Mills "patternProperties": { 181*f2a8e57eSGunnar Mills "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 182*f2a8e57eSGunnar Mills "description": "This property shall specify a valid odata or Redfish property.", 183*f2a8e57eSGunnar Mills "type": [ 184*f2a8e57eSGunnar Mills "array", 185*f2a8e57eSGunnar Mills "boolean", 186*f2a8e57eSGunnar Mills "integer", 187*f2a8e57eSGunnar Mills "number", 188*f2a8e57eSGunnar Mills "null", 189*f2a8e57eSGunnar Mills "object", 190*f2a8e57eSGunnar Mills "string" 191*f2a8e57eSGunnar Mills ] 192*f2a8e57eSGunnar Mills } 193*f2a8e57eSGunnar Mills }, 194*f2a8e57eSGunnar Mills "properties": {}, 195*f2a8e57eSGunnar Mills "type": "object" 196*f2a8e57eSGunnar Mills }, 197*f2a8e57eSGunnar Mills "Threshold": { 198*f2a8e57eSGunnar Mills "additionalProperties": false, 199*f2a8e57eSGunnar Mills "description": "A threshold definition for a metric.", 200*f2a8e57eSGunnar Mills "longDescription": "This type shall contain the properties for an individual threshold for this metric.", 201*f2a8e57eSGunnar Mills "patternProperties": { 202*f2a8e57eSGunnar Mills "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 203*f2a8e57eSGunnar Mills "description": "This property shall specify a valid odata or Redfish property.", 204*f2a8e57eSGunnar Mills "type": [ 205*f2a8e57eSGunnar Mills "array", 206*f2a8e57eSGunnar Mills "boolean", 207*f2a8e57eSGunnar Mills "integer", 208*f2a8e57eSGunnar Mills "number", 209*f2a8e57eSGunnar Mills "null", 210*f2a8e57eSGunnar Mills "object", 211*f2a8e57eSGunnar Mills "string" 212*f2a8e57eSGunnar Mills ] 213*f2a8e57eSGunnar Mills } 214*f2a8e57eSGunnar Mills }, 215*f2a8e57eSGunnar Mills "properties": { 216*f2a8e57eSGunnar Mills "Activation": { 217*f2a8e57eSGunnar Mills "anyOf": [ 218*f2a8e57eSGunnar Mills { 219*f2a8e57eSGunnar Mills "$ref": "#/definitions/ThresholdActivation" 220*f2a8e57eSGunnar Mills }, 221*f2a8e57eSGunnar Mills { 222*f2a8e57eSGunnar Mills "type": "null" 223*f2a8e57eSGunnar Mills } 224*f2a8e57eSGunnar Mills ], 225*f2a8e57eSGunnar Mills "description": "The direction of crossing that activates this threshold.", 226*f2a8e57eSGunnar Mills "longDescription": "This property shall indicate the direction of crossing of the reading for this metric that activates the threshold.", 227*f2a8e57eSGunnar Mills "readonly": false 228*f2a8e57eSGunnar Mills }, 229*f2a8e57eSGunnar Mills "DwellTime": { 230*f2a8e57eSGunnar Mills "description": "The duration the metric value must violate the threshold before the threshold is activated.", 231*f2a8e57eSGunnar Mills "longDescription": "This property shall indicate the duration the metric value violates the threshold before the threshold is activated.", 232*f2a8e57eSGunnar Mills "pattern": "^P(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+(.\\d+)?S)?)?$", 233*f2a8e57eSGunnar Mills "readonly": false, 234*f2a8e57eSGunnar Mills "type": [ 235*f2a8e57eSGunnar Mills "string", 236*f2a8e57eSGunnar Mills "null" 237*f2a8e57eSGunnar Mills ] 238*f2a8e57eSGunnar Mills }, 239*f2a8e57eSGunnar Mills "Reading": { 240*f2a8e57eSGunnar Mills "description": "The threshold value.", 241*f2a8e57eSGunnar Mills "longDescription": "This property shall indicate the reading for this metric that activates the threshold. The value of the property shall use the same units as the `MetricProperties` property.", 242*f2a8e57eSGunnar Mills "readonly": false, 243*f2a8e57eSGunnar Mills "type": [ 244*f2a8e57eSGunnar Mills "number", 245*f2a8e57eSGunnar Mills "null" 246*f2a8e57eSGunnar Mills ] 247*f2a8e57eSGunnar Mills } 248*f2a8e57eSGunnar Mills }, 249*f2a8e57eSGunnar Mills "type": "object" 250*f2a8e57eSGunnar Mills }, 251*f2a8e57eSGunnar Mills "ThresholdActivation": { 252*f2a8e57eSGunnar Mills "enum": [ 253*f2a8e57eSGunnar Mills "Increasing", 254*f2a8e57eSGunnar Mills "Decreasing", 255*f2a8e57eSGunnar Mills "Either", 256*f2a8e57eSGunnar Mills "Disabled" 257*f2a8e57eSGunnar Mills ], 258*f2a8e57eSGunnar Mills "enumDescriptions": { 259*f2a8e57eSGunnar Mills "Decreasing": "Value decreases below the threshold.", 260*f2a8e57eSGunnar Mills "Disabled": "The threshold is disabled.", 261*f2a8e57eSGunnar Mills "Either": "Value crosses the threshold in either direction.", 262*f2a8e57eSGunnar Mills "Increasing": "Value increases above the threshold." 263*f2a8e57eSGunnar Mills }, 264*f2a8e57eSGunnar Mills "enumLongDescriptions": { 265*f2a8e57eSGunnar Mills "Decreasing": "This threshold is activated when the reading changes from a value higher than the threshold to a value lower than the threshold.", 266*f2a8e57eSGunnar Mills "Disabled": "This value shall indicate the threshold is disabled and no actions shall be taken as a result of the reading crossing the threshold value.", 267*f2a8e57eSGunnar Mills "Either": "This threshold is activated when either the `Increasing` or `Decreasing` conditions are met.", 268*f2a8e57eSGunnar Mills "Increasing": "This threshold is activated when the reading changes from a value lower than the threshold to a value higher than the threshold." 269*f2a8e57eSGunnar Mills }, 270*f2a8e57eSGunnar Mills "enumVersionAdded": { 271*f2a8e57eSGunnar Mills "Disabled": "v1_3_0" 272*f2a8e57eSGunnar Mills }, 273*f2a8e57eSGunnar Mills "type": "string" 274*f2a8e57eSGunnar Mills }, 275*f2a8e57eSGunnar Mills "Thresholds": { 276*f2a8e57eSGunnar Mills "additionalProperties": false, 277*f2a8e57eSGunnar Mills "description": "The set of thresholds for a metric.", 278*f2a8e57eSGunnar Mills "longDescription": "This type shall contain a set of thresholds for a metric.", 279*f2a8e57eSGunnar Mills "patternProperties": { 280*f2a8e57eSGunnar Mills "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 281*f2a8e57eSGunnar Mills "description": "This property shall specify a valid odata or Redfish property.", 282*f2a8e57eSGunnar Mills "type": [ 283*f2a8e57eSGunnar Mills "array", 284*f2a8e57eSGunnar Mills "boolean", 285*f2a8e57eSGunnar Mills "integer", 286*f2a8e57eSGunnar Mills "number", 287*f2a8e57eSGunnar Mills "null", 288*f2a8e57eSGunnar Mills "object", 289*f2a8e57eSGunnar Mills "string" 290*f2a8e57eSGunnar Mills ] 291*f2a8e57eSGunnar Mills } 292*f2a8e57eSGunnar Mills }, 293*f2a8e57eSGunnar Mills "properties": { 294*f2a8e57eSGunnar Mills "LowerCritical": { 295*f2a8e57eSGunnar Mills "$ref": "#/definitions/Threshold", 296*f2a8e57eSGunnar Mills "description": "The value at which the reading is below normal range and requires attention.", 297*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the value at which the `MetricProperties` property is below the normal range and may require attention. The value of the property shall use the same units as the `MetricProperties` property." 298*f2a8e57eSGunnar Mills }, 299*f2a8e57eSGunnar Mills "LowerWarning": { 300*f2a8e57eSGunnar Mills "$ref": "#/definitions/Threshold", 301*f2a8e57eSGunnar Mills "description": "The value at which the reading is below normal range.", 302*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the value at which the `MetricProperties` property is below the normal range. The value of the property shall use the same units as the `MetricProperties` property." 303*f2a8e57eSGunnar Mills }, 304*f2a8e57eSGunnar Mills "UpperCritical": { 305*f2a8e57eSGunnar Mills "$ref": "#/definitions/Threshold", 306*f2a8e57eSGunnar Mills "description": "The value at which the reading is above normal range and requires attention.", 307*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the value at which the `MetricProperties` property is above the normal range and may require attention. The value of the property shall use the same units as the `MetricProperties` property." 308*f2a8e57eSGunnar Mills }, 309*f2a8e57eSGunnar Mills "UpperWarning": { 310*f2a8e57eSGunnar Mills "$ref": "#/definitions/Threshold", 311*f2a8e57eSGunnar Mills "description": "The value at which the reading is above normal range.", 312*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the value at which the `MetricProperties` property is above the normal range. The value of the property shall use the same units as the `MetricProperties` property." 313*f2a8e57eSGunnar Mills } 314*f2a8e57eSGunnar Mills }, 315*f2a8e57eSGunnar Mills "type": "object" 316*f2a8e57eSGunnar Mills }, 317*f2a8e57eSGunnar Mills "TriggerActionEnum": { 318*f2a8e57eSGunnar Mills "description": "The actions to perform when a trigger condition is met.", 319*f2a8e57eSGunnar Mills "enum": [ 320*f2a8e57eSGunnar Mills "LogToLogService", 321*f2a8e57eSGunnar Mills "RedfishEvent", 322*f2a8e57eSGunnar Mills "RedfishMetricReport" 323*f2a8e57eSGunnar Mills ], 324*f2a8e57eSGunnar Mills "enumDescriptions": { 325*f2a8e57eSGunnar Mills "LogToLogService": "When a trigger condition is met, record in a log.", 326*f2a8e57eSGunnar Mills "RedfishEvent": "When a trigger condition is met, the service sends an event to subscribers.", 327*f2a8e57eSGunnar Mills "RedfishMetricReport": "When a trigger condition is met, force an update of the specified metric reports." 328*f2a8e57eSGunnar Mills }, 329*f2a8e57eSGunnar Mills "enumLongDescriptions": { 330*f2a8e57eSGunnar Mills "LogToLogService": "This value indicates that when a trigger condition is met, the service shall log the occurrence of the condition to the log that the `LogService` property in the telemetry service resource describes. The message for the created log entry shall follow the guidance specified by the `TriggerActionMessage` property.", 331*f2a8e57eSGunnar Mills "RedfishEvent": "This value indicates that when a trigger condition is met, the service shall send an event to subscribers. The message key for the event shall follow the guidance specified by TriggerActionMessage.", 332*f2a8e57eSGunnar Mills "RedfishMetricReport": "This value indicates that when a trigger condition is met, the service shall force the metric reports managed by the metric report definitions specified by the `MetricReportDefinitions` property to be updated, regardless of the `MetricReportDefinitionType` property value. The actions specified in the `ReportActions` property of each `MetricReportDefinition` resource shall be performed." 333*f2a8e57eSGunnar Mills }, 334*f2a8e57eSGunnar Mills "enumVersionAdded": { 335*f2a8e57eSGunnar Mills "RedfishMetricReport": "v1_1_0" 336*f2a8e57eSGunnar Mills }, 337*f2a8e57eSGunnar Mills "longDescription": "This type shall specify the actions to perform when a trigger condition is met.", 338*f2a8e57eSGunnar Mills "type": "string" 339*f2a8e57eSGunnar Mills }, 340*f2a8e57eSGunnar Mills "TriggerActionMessage": { 341*f2a8e57eSGunnar Mills "description": "The message used for events or log entries when the trigger is activated.", 342*f2a8e57eSGunnar Mills "enum": [ 343*f2a8e57eSGunnar Mills "Telemetry", 344*f2a8e57eSGunnar Mills "DriveMediaLife", 345*f2a8e57eSGunnar Mills "ConnectionSpeed" 346*f2a8e57eSGunnar Mills ], 347*f2a8e57eSGunnar Mills "enumDescriptions": { 348*f2a8e57eSGunnar Mills "ConnectionSpeed": "`ConnectionSpeedLow` message from the Network Device Message Registry.", 349*f2a8e57eSGunnar Mills "DriveMediaLife": "`MediaLifeLeftLow` message from the Storage Device Message Registry.", 350*f2a8e57eSGunnar Mills "Telemetry": "Messages from the Telemetry Message Registry." 351*f2a8e57eSGunnar Mills }, 352*f2a8e57eSGunnar Mills "enumLongDescriptions": { 353*f2a8e57eSGunnar Mills "ConnectionSpeed": "This value shall indicate that messages generated in response to a trigger action shall utilize the `ConnectionSpeedLow` message from the Network Device Message Registry.", 354*f2a8e57eSGunnar Mills "DriveMediaLife": "This value shall indicate that messages generated in response to a trigger action shall utilize the `MediaLifeLeftLow` message from the Storage Device Message Registry.", 355*f2a8e57eSGunnar Mills "Telemetry": "This value shall indicate that messages generated in response to a trigger action shall utilize messages from the Telemetry Message Registry. If this property is not supplied or supported, this value should be used as the default for this trigger." 356*f2a8e57eSGunnar Mills }, 357*f2a8e57eSGunnar Mills "longDescription": "The value shall indicate the message used to complete the specified trigger actions.", 358*f2a8e57eSGunnar Mills "type": "string" 359*f2a8e57eSGunnar Mills }, 360*f2a8e57eSGunnar Mills "Triggers": { 361*f2a8e57eSGunnar Mills "additionalProperties": false, 362*f2a8e57eSGunnar Mills "description": "The `Triggers` schema describes a trigger condition that applies to metrics.", 363*f2a8e57eSGunnar Mills "longDescription": "This resource shall contain a trigger condition that applies to metrics.", 364*f2a8e57eSGunnar Mills "patternProperties": { 365*f2a8e57eSGunnar Mills "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 366*f2a8e57eSGunnar Mills "description": "This property shall specify a valid odata or Redfish property.", 367*f2a8e57eSGunnar Mills "type": [ 368*f2a8e57eSGunnar Mills "array", 369*f2a8e57eSGunnar Mills "boolean", 370*f2a8e57eSGunnar Mills "integer", 371*f2a8e57eSGunnar Mills "number", 372*f2a8e57eSGunnar Mills "null", 373*f2a8e57eSGunnar Mills "object", 374*f2a8e57eSGunnar Mills "string" 375*f2a8e57eSGunnar Mills ] 376*f2a8e57eSGunnar Mills } 377*f2a8e57eSGunnar Mills }, 378*f2a8e57eSGunnar Mills "properties": { 379*f2a8e57eSGunnar Mills "@odata.context": { 380*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/context" 381*f2a8e57eSGunnar Mills }, 382*f2a8e57eSGunnar Mills "@odata.etag": { 383*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/etag" 384*f2a8e57eSGunnar Mills }, 385*f2a8e57eSGunnar Mills "@odata.id": { 386*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/id" 387*f2a8e57eSGunnar Mills }, 388*f2a8e57eSGunnar Mills "@odata.type": { 389*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/type" 390*f2a8e57eSGunnar Mills }, 391*f2a8e57eSGunnar Mills "Actions": { 392*f2a8e57eSGunnar Mills "$ref": "#/definitions/Actions", 393*f2a8e57eSGunnar Mills "description": "The available actions for this resource.", 394*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the available actions for this resource." 395*f2a8e57eSGunnar Mills }, 396*f2a8e57eSGunnar Mills "Description": { 397*f2a8e57eSGunnar Mills "anyOf": [ 398*f2a8e57eSGunnar Mills { 399*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Description" 400*f2a8e57eSGunnar Mills }, 401*f2a8e57eSGunnar Mills { 402*f2a8e57eSGunnar Mills "type": "null" 403*f2a8e57eSGunnar Mills } 404*f2a8e57eSGunnar Mills ], 405*f2a8e57eSGunnar Mills "readonly": true 406*f2a8e57eSGunnar Mills }, 407*f2a8e57eSGunnar Mills "DiscreteTriggerCondition": { 408*f2a8e57eSGunnar Mills "anyOf": [ 409*f2a8e57eSGunnar Mills { 410*f2a8e57eSGunnar Mills "$ref": "#/definitions/DiscreteTriggerConditionEnum" 411*f2a8e57eSGunnar Mills }, 412*f2a8e57eSGunnar Mills { 413*f2a8e57eSGunnar Mills "type": "null" 414*f2a8e57eSGunnar Mills } 415*f2a8e57eSGunnar Mills ], 416*f2a8e57eSGunnar Mills "description": "The conditions for a discrete metric trigger.", 417*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the conditions when a discrete metric triggers.", 418*f2a8e57eSGunnar Mills "readonly": true 419*f2a8e57eSGunnar Mills }, 420*f2a8e57eSGunnar Mills "DiscreteTriggers": { 421*f2a8e57eSGunnar Mills "description": "The list of discrete triggers.", 422*f2a8e57eSGunnar Mills "items": { 423*f2a8e57eSGunnar Mills "$ref": "#/definitions/DiscreteTrigger" 424*f2a8e57eSGunnar Mills }, 425*f2a8e57eSGunnar Mills "longDescription": "This property shall contain a list of values to which to compare a metric reading. This property shall be present when the `DiscreteTriggerCondition` property is `Specified`.", 426*f2a8e57eSGunnar Mills "type": "array" 427*f2a8e57eSGunnar Mills }, 428*f2a8e57eSGunnar Mills "EventTriggers": { 429*f2a8e57eSGunnar Mills "description": "The array of `MessageId` values that specify when a trigger condition is met based on an event.", 430*f2a8e57eSGunnar Mills "items": { 431*f2a8e57eSGunnar Mills "type": [ 432*f2a8e57eSGunnar Mills "string", 433*f2a8e57eSGunnar Mills "null" 434*f2a8e57eSGunnar Mills ] 435*f2a8e57eSGunnar Mills }, 436*f2a8e57eSGunnar Mills "longDescription": "This property shall contain an array of `MessageId` values that specify when a trigger condition is met based on an event. When the service generates an event and if it contains a `MessageId` within this array, a trigger condition shall be met. The `MetricType` property should not be present if this resource is configured for event-based triggers.", 437*f2a8e57eSGunnar Mills "pattern": "^[A-Za-z0-9]+\\.\\d+\\.\\d+\\.[A-Za-z0-9.]+$", 438*f2a8e57eSGunnar Mills "readonly": false, 439*f2a8e57eSGunnar Mills "type": "array", 440*f2a8e57eSGunnar Mills "versionAdded": "v1_1_0" 441*f2a8e57eSGunnar Mills }, 442*f2a8e57eSGunnar Mills "HysteresisDuration": { 443*f2a8e57eSGunnar Mills "description": "The duration the metric value must not violate the threshold before the threshold is deactivated.", 444*f2a8e57eSGunnar Mills "longDescription": "This property shall indicate the duration the metric value no longer violates the threshold before the threshold is deactivated. A duration of zero seconds, or if the property is not present in the resource, shall indicate the threshold is deactivated immediately once the metric value no longer violates the threshold. The threshold shall not deactivate until the conditions of both `HysteresisReading` and `HysteresisDuration` are met.", 445*f2a8e57eSGunnar Mills "pattern": "^P(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+(.\\d+)?S)?)?$", 446*f2a8e57eSGunnar Mills "readonly": false, 447*f2a8e57eSGunnar Mills "type": [ 448*f2a8e57eSGunnar Mills "string", 449*f2a8e57eSGunnar Mills "null" 450*f2a8e57eSGunnar Mills ], 451*f2a8e57eSGunnar Mills "versionAdded": "v1_3_0" 452*f2a8e57eSGunnar Mills }, 453*f2a8e57eSGunnar Mills "HysteresisReading": { 454*f2a8e57eSGunnar Mills "description": "The reading offset from the threshold value required to clear the threshold.", 455*f2a8e57eSGunnar Mills "longDescription": "This property shall indicate the offset from the reading for this sensor and the threshold value that deactivates the threshold. For example, a value of `-2` indicates the metric reading shall fall 2 units below an upper threshold value to deactivate the threshold. The value of the property shall use the same units as the `Reading` property. A value of `0`, or if the property is not present in the resource, shall indicate the threshold is deactivated when the metric value no longer violates the threshold. The threshold shall not deactivate until the conditions of both `HysteresisReading` and `HysteresisDuration` are met.", 456*f2a8e57eSGunnar Mills "readonly": false, 457*f2a8e57eSGunnar Mills "type": [ 458*f2a8e57eSGunnar Mills "number", 459*f2a8e57eSGunnar Mills "null" 460*f2a8e57eSGunnar Mills ], 461*f2a8e57eSGunnar Mills "versionAdded": "v1_3_0" 462*f2a8e57eSGunnar Mills }, 463*f2a8e57eSGunnar Mills "Id": { 464*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Id", 465*f2a8e57eSGunnar Mills "readonly": true 466*f2a8e57eSGunnar Mills }, 467*f2a8e57eSGunnar Mills "Links": { 468*f2a8e57eSGunnar Mills "$ref": "#/definitions/Links", 469*f2a8e57eSGunnar Mills "description": "The links to other resources that are related to this resource.", 470*f2a8e57eSGunnar Mills "longDescription": "This property shall contain links to resources that are related to but are not contained by, or subordinate to, this resource.", 471*f2a8e57eSGunnar Mills "versionAdded": "v1_1_0" 472*f2a8e57eSGunnar Mills }, 473*f2a8e57eSGunnar Mills "MetricIds": { 474*f2a8e57eSGunnar Mills "description": "The label for the metric definitions that contain the property identifiers for this trigger. It matches the `Id` property of the corresponding metric definition.", 475*f2a8e57eSGunnar Mills "items": { 476*f2a8e57eSGunnar Mills "type": [ 477*f2a8e57eSGunnar Mills "string", 478*f2a8e57eSGunnar Mills "null" 479*f2a8e57eSGunnar Mills ] 480*f2a8e57eSGunnar Mills }, 481*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the labels for the metric definitions that contain the property identifiers for this trigger. This property shall match the value of the `Id` property of the corresponding metric definitions.", 482*f2a8e57eSGunnar Mills "readonly": false, 483*f2a8e57eSGunnar Mills "type": "array", 484*f2a8e57eSGunnar Mills "versionAdded": "v1_2_0" 485*f2a8e57eSGunnar Mills }, 486*f2a8e57eSGunnar Mills "MetricProperties": { 487*f2a8e57eSGunnar Mills "description": "An array of URIs with wildcards and property identifiers for this trigger. Each wildcard, a name contained by a set of curly braces, is replaced with its corresponding entry in the `Wildcard` array property.", 488*f2a8e57eSGunnar Mills "format": "uri-reference", 489*f2a8e57eSGunnar Mills "items": { 490*f2a8e57eSGunnar Mills "type": [ 491*f2a8e57eSGunnar Mills "string", 492*f2a8e57eSGunnar Mills "null" 493*f2a8e57eSGunnar Mills ] 494*f2a8e57eSGunnar Mills }, 495*f2a8e57eSGunnar Mills "longDescription": "This property shall contain an array of URIs with wildcards and property identifiers for this trigger. Use a set of curly braces to delimit each wildcard in the URI. Replace each wildcard with its corresponding entry in the `Wildcard` array property. A URI that contains wildcards shall link to a resource property to which this trigger definition applies after all wildcards are replaced with their corresponding entries in the Wildcard property. The property identifiers portion of the URI shall follow the RFC6901-defined JSON fragment notation rules.", 496*f2a8e57eSGunnar Mills "readonly": false, 497*f2a8e57eSGunnar Mills "type": "array" 498*f2a8e57eSGunnar Mills }, 499*f2a8e57eSGunnar Mills "MetricType": { 500*f2a8e57eSGunnar Mills "anyOf": [ 501*f2a8e57eSGunnar Mills { 502*f2a8e57eSGunnar Mills "$ref": "#/definitions/MetricTypeEnum" 503*f2a8e57eSGunnar Mills }, 504*f2a8e57eSGunnar Mills { 505*f2a8e57eSGunnar Mills "type": "null" 506*f2a8e57eSGunnar Mills } 507*f2a8e57eSGunnar Mills ], 508*f2a8e57eSGunnar Mills "description": "The metric type of the trigger.", 509*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the metric type of the trigger.", 510*f2a8e57eSGunnar Mills "readonly": true 511*f2a8e57eSGunnar Mills }, 512*f2a8e57eSGunnar Mills "Name": { 513*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Name", 514*f2a8e57eSGunnar Mills "readonly": true 515*f2a8e57eSGunnar Mills }, 516*f2a8e57eSGunnar Mills "NumericThresholds": { 517*f2a8e57eSGunnar Mills "$ref": "#/definitions/Thresholds", 518*f2a8e57eSGunnar Mills "description": "The thresholds for a numeric metric trigger.", 519*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the list of thresholds to which to compare a numeric metric value." 520*f2a8e57eSGunnar Mills }, 521*f2a8e57eSGunnar Mills "Oem": { 522*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem", 523*f2a8e57eSGunnar Mills "description": "The OEM extension property.", 524*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the OEM extensions. All values for properties that this object contains shall conform to the Redfish Specification-described requirements." 525*f2a8e57eSGunnar Mills }, 526*f2a8e57eSGunnar Mills "Status": { 527*f2a8e57eSGunnar Mills "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Status", 528*f2a8e57eSGunnar Mills "description": "The status and health of the resource and its subordinate or dependent resources.", 529*f2a8e57eSGunnar Mills "longDescription": "This property shall contain any status or health properties of the resource." 530*f2a8e57eSGunnar Mills }, 531*f2a8e57eSGunnar Mills "TriggerActionMessage": { 532*f2a8e57eSGunnar Mills "anyOf": [ 533*f2a8e57eSGunnar Mills { 534*f2a8e57eSGunnar Mills "$ref": "#/definitions/TriggerActionMessage" 535*f2a8e57eSGunnar Mills }, 536*f2a8e57eSGunnar Mills { 537*f2a8e57eSGunnar Mills "type": "null" 538*f2a8e57eSGunnar Mills } 539*f2a8e57eSGunnar Mills ], 540*f2a8e57eSGunnar Mills "description": "The message issued as part of the trigger actions.", 541*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the message definition used to generate a Redfish event or a log entry as requested by the values of `TriggerActions`.", 542*f2a8e57eSGunnar Mills "readonly": false, 543*f2a8e57eSGunnar Mills "versionAdded": "v1_4_0" 544*f2a8e57eSGunnar Mills }, 545*f2a8e57eSGunnar Mills "TriggerActions": { 546*f2a8e57eSGunnar Mills "description": "The actions that the trigger initiates.", 547*f2a8e57eSGunnar Mills "items": { 548*f2a8e57eSGunnar Mills "$ref": "#/definitions/TriggerActionEnum" 549*f2a8e57eSGunnar Mills }, 550*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the actions that the trigger initiates.", 551*f2a8e57eSGunnar Mills "readonly": true, 552*f2a8e57eSGunnar Mills "type": "array" 553*f2a8e57eSGunnar Mills }, 554*f2a8e57eSGunnar Mills "TriggerEnabled": { 555*f2a8e57eSGunnar Mills "description": "An indication of whether the trigger is enabled.", 556*f2a8e57eSGunnar Mills "longDescription": "This property shall indicate whether the trigger is enabled. If `true`, it is enabled. If `false`, it is disabled and none of the actions listed in `TriggerActions` will occur.", 557*f2a8e57eSGunnar Mills "readonly": false, 558*f2a8e57eSGunnar Mills "type": [ 559*f2a8e57eSGunnar Mills "boolean", 560*f2a8e57eSGunnar Mills "null" 561*f2a8e57eSGunnar Mills ], 562*f2a8e57eSGunnar Mills "versionAdded": "v1_4_0" 563*f2a8e57eSGunnar Mills }, 564*f2a8e57eSGunnar Mills "Wildcards": { 565*f2a8e57eSGunnar Mills "description": "The wildcards and their substitution values for the entries in the `MetricProperties` array property.", 566*f2a8e57eSGunnar Mills "items": { 567*f2a8e57eSGunnar Mills "$ref": "#/definitions/Wildcard" 568*f2a8e57eSGunnar Mills }, 569*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the wildcards and their substitution values for the entries in the `MetricProperties` array property. Each wildcard shall have a corresponding entry in this array property.", 570*f2a8e57eSGunnar Mills "type": "array" 571*f2a8e57eSGunnar Mills } 572*f2a8e57eSGunnar Mills }, 573*f2a8e57eSGunnar Mills "required": [ 574*f2a8e57eSGunnar Mills "@odata.id", 575*f2a8e57eSGunnar Mills "@odata.type", 576*f2a8e57eSGunnar Mills "Id", 577*f2a8e57eSGunnar Mills "Name" 578*f2a8e57eSGunnar Mills ], 579*f2a8e57eSGunnar Mills "type": "object" 580*f2a8e57eSGunnar Mills }, 581*f2a8e57eSGunnar Mills "Wildcard": { 582*f2a8e57eSGunnar Mills "additionalProperties": false, 583*f2a8e57eSGunnar Mills "description": "The wildcard and its substitution values.", 584*f2a8e57eSGunnar Mills "longDescription": "This property shall contain a wildcard and its substitution values.", 585*f2a8e57eSGunnar Mills "patternProperties": { 586*f2a8e57eSGunnar Mills "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { 587*f2a8e57eSGunnar Mills "description": "This property shall specify a valid odata or Redfish property.", 588*f2a8e57eSGunnar Mills "type": [ 589*f2a8e57eSGunnar Mills "array", 590*f2a8e57eSGunnar Mills "boolean", 591*f2a8e57eSGunnar Mills "integer", 592*f2a8e57eSGunnar Mills "number", 593*f2a8e57eSGunnar Mills "null", 594*f2a8e57eSGunnar Mills "object", 595*f2a8e57eSGunnar Mills "string" 596*f2a8e57eSGunnar Mills ] 597*f2a8e57eSGunnar Mills } 598*f2a8e57eSGunnar Mills }, 599*f2a8e57eSGunnar Mills "properties": { 600*f2a8e57eSGunnar Mills "Name": { 601*f2a8e57eSGunnar Mills "description": "The wildcard.", 602*f2a8e57eSGunnar Mills "longDescription": "This property shall contain the string used as a wildcard when contained by curly braces for a URI segment in `MetricProperties`.", 603*f2a8e57eSGunnar Mills "readonly": true, 604*f2a8e57eSGunnar Mills "type": [ 605*f2a8e57eSGunnar Mills "string", 606*f2a8e57eSGunnar Mills "null" 607*f2a8e57eSGunnar Mills ] 608*f2a8e57eSGunnar Mills }, 609*f2a8e57eSGunnar Mills "Values": { 610*f2a8e57eSGunnar Mills "description": "An array of values to substitute for the wildcard. A single value of `*` matches all resources.", 611*f2a8e57eSGunnar Mills "items": { 612*f2a8e57eSGunnar Mills "type": [ 613*f2a8e57eSGunnar Mills "string", 614*f2a8e57eSGunnar Mills "null" 615*f2a8e57eSGunnar Mills ] 616*f2a8e57eSGunnar Mills }, 617*f2a8e57eSGunnar Mills "longDescription": "This array property shall contain the list of values to substitute for the wildcard. A single value of `*` shall indicate that the wildcard matches any available values when substituted for a URI segment. If this property is not present, the value shall be assumed to be `*`.", 618*f2a8e57eSGunnar Mills "readonly": false, 619*f2a8e57eSGunnar Mills "type": "array" 620*f2a8e57eSGunnar Mills } 621*f2a8e57eSGunnar Mills }, 622*f2a8e57eSGunnar Mills "type": "object" 623*f2a8e57eSGunnar Mills } 624*f2a8e57eSGunnar Mills }, 625*f2a8e57eSGunnar Mills "language": "en", 626*f2a8e57eSGunnar Mills "owningEntity": "DMTF", 627*f2a8e57eSGunnar Mills "release": "2024.1", 628*f2a8e57eSGunnar Mills "title": "#Triggers.v1_4_0.Triggers" 629*f2a8e57eSGunnar Mills}