xref: /openbmc/bmcweb/features/redfish/schema/dmtf/json-schema/LeakDetector.v1_4_0.json (revision c6d7a45d427f9a6d9e761afcf305761dca60d7cf)
1{
2    "$id": "http://redfish.dmtf.org/schemas/v1/LeakDetector.v1_4_0.json",
3    "$ref": "#/definitions/LeakDetector",
4    "$schema": "http://redfish.dmtf.org/schemas/v1/redfish-schema-v1.json",
5    "copyright": "Copyright 2014-2025 DMTF. For the full DMTF copyright policy, see http://www.dmtf.org/about/policies/copyright",
6    "definitions": {
7        "Actions": {
8            "additionalProperties": false,
9            "description": "The available actions for this resource.",
10            "longDescription": "This type shall contain the available actions for this resource.",
11            "patternProperties": {
12                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
13                    "description": "This property shall specify a valid odata or Redfish property.",
14                    "type": [
15                        "array",
16                        "boolean",
17                        "integer",
18                        "number",
19                        "null",
20                        "object",
21                        "string"
22                    ]
23                }
24            },
25            "properties": {
26                "Oem": {
27                    "$ref": "#/definitions/OemActions",
28                    "description": "The available OEM-specific actions for this resource.",
29                    "longDescription": "This property shall contain the available OEM-specific actions for this resource."
30                }
31            },
32            "type": "object"
33        },
34        "LeakDetector": {
35            "additionalProperties": false,
36            "description": "The `LeakDetector` schema describes a state-based or digital-value leak detector and its properties.",
37            "longDescription": "This resource shall represent a state-based or digital-value leak detector for a Redfish implementation.",
38            "patternProperties": {
39                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
40                    "description": "This property shall specify a valid odata or Redfish property.",
41                    "type": [
42                        "array",
43                        "boolean",
44                        "integer",
45                        "number",
46                        "null",
47                        "object",
48                        "string"
49                    ]
50                }
51            },
52            "properties": {
53                "@odata.context": {
54                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/context"
55                },
56                "@odata.etag": {
57                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/etag"
58                },
59                "@odata.id": {
60                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/id"
61                },
62                "@odata.type": {
63                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/type"
64                },
65                "Actions": {
66                    "$ref": "#/definitions/Actions",
67                    "description": "The available actions for this resource.",
68                    "longDescription": "This property shall contain the available actions for this resource."
69                },
70                "CriticalReactionType": {
71                    "$ref": "#/definitions/ReactionType",
72                    "description": "The reaction to perform when a critical leak is detected.",
73                    "longDescription": "The reaction that shall be performed when the `DetectorState` property changes to `Critical`.",
74                    "readonly": false,
75                    "versionAdded": "v1_4_0"
76                },
77                "Description": {
78                    "anyOf": [
79                        {
80                            "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Description"
81                        },
82                        {
83                            "type": "null"
84                        }
85                    ],
86                    "readonly": true
87                },
88                "DetectorState": {
89                    "anyOf": [
90                        {
91                            "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Health"
92                        },
93                        {
94                            "type": "null"
95                        }
96                    ],
97                    "description": "The state of the leak detector.",
98                    "excerpt": "LeakDetector",
99                    "longDescription": "This property shall contain the state of the leak detector.  The value of this property should equate the value of `Health` in `Status`, and was created primarily for use in excerpts of this resource.",
100                    "readonly": true
101                },
102                "Enabled": {
103                    "description": "Indicates whether the leak detector is enabled and provides a status.",
104                    "longDescription": "This property shall indicate whether the leak detector is enabled and provides a `DetectorState`.  The value `true` shall indicate the leak detector is enabled and returns the `DetectorState` property with a valid value.  The value `false` shall indicate the leak detector is disabled, shall not return the `DetectorState` property, and shall not trigger events, logging, or other functionality.  This property allows a user to disable a faulty leak detector or to otherwise remove it from use.",
105                    "readonly": false,
106                    "type": [
107                        "boolean",
108                        "null"
109                    ],
110                    "versionAdded": "v1_3_0"
111                },
112                "Id": {
113                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Id",
114                    "readonly": true
115                },
116                "LeakDetectorType": {
117                    "anyOf": [
118                        {
119                            "$ref": "#/definitions/LeakDetectorType"
120                        },
121                        {
122                            "type": "null"
123                        }
124                    ],
125                    "description": "The type of leak detection sensor.",
126                    "longDescription": "This property shall contain the reading type of the leak detection sensor.",
127                    "readonly": true
128                },
129                "Location": {
130                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Location",
131                    "description": "The location information for this leak detector.",
132                    "longDescription": "This property shall indicate the location information for this leak detector."
133                },
134                "Manufacturer": {
135                    "description": "The manufacturer of this leak detector.",
136                    "longDescription": "This property shall contain the name of the organization responsible for producing the leak detector.  This organization may be the entity from whom the leak detector is purchased, but this is not necessarily true.",
137                    "readonly": true,
138                    "type": [
139                        "string",
140                        "null"
141                    ]
142                },
143                "Model": {
144                    "description": "The model number of the leak detector.",
145                    "longDescription": "This property shall contain the name by which the manufacturer generally refers to the leak detector.",
146                    "readonly": true,
147                    "type": [
148                        "string",
149                        "null"
150                    ]
151                },
152                "Name": {
153                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Name",
154                    "readonly": true
155                },
156                "Oem": {
157                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem",
158                    "description": "The OEM extension property.",
159                    "longDescription": "This property shall contain the OEM extensions.  All values for properties that this object contains shall conform to the Redfish Specification-described requirements."
160                },
161                "PartNumber": {
162                    "description": "The part number of the leak detector.",
163                    "longDescription": "This property shall contain a part number assigned by the organization that is responsible for producing or manufacturing the leak detector.",
164                    "readonly": true,
165                    "type": [
166                        "string",
167                        "null"
168                    ]
169                },
170                "PhysicalContext": {
171                    "anyOf": [
172                        {
173                            "$ref": "http://redfish.dmtf.org/schemas/v1/PhysicalContext.json#/definitions/PhysicalContext"
174                        },
175                        {
176                            "type": "null"
177                        }
178                    ],
179                    "description": "The area or device to which this leak detector applies.",
180                    "excerpt": "LeakDetectorArray",
181                    "longDescription": "This property shall contain a description of the affected component or region within the equipment to which this leak detector applies.",
182                    "readonly": true
183                },
184                "PhysicalSubContext": {
185                    "anyOf": [
186                        {
187                            "$ref": "http://redfish.dmtf.org/schemas/v1/PhysicalContext.json#/definitions/PhysicalSubContext"
188                        },
189                        {
190                            "type": "null"
191                        }
192                    ],
193                    "description": "The usage or location within a device to which this leak detector applies.",
194                    "excerpt": "LeakDetectorArray",
195                    "longDescription": "This property shall contain a description of the usage or sub-region within the equipment to which this leak detector applies.  This property generally differentiates multiple leak detectors within the same `PhysicalContext` instance.",
196                    "readonly": true
197                },
198                "ReactionDelaySeconds": {
199                    "description": "The delay in seconds after a leak is detected before the selected reaction is executed.",
200                    "longDescription": "The value shall indicate the number of seconds to delay after the `DetectorState` changes before the selected reaction is executed.  If the `DetectorState` returns to `OK` prior to the delay value, the service shall not perform the reaction.",
201                    "readonly": false,
202                    "type": "integer",
203                    "units": "s",
204                    "versionAdded": "v1_4_0"
205                },
206                "SKU": {
207                    "description": "The SKU of the leak detector.",
208                    "longDescription": "This property shall contain the stock-keeping unit number for this leak detector.",
209                    "readonly": true,
210                    "type": [
211                        "string",
212                        "null"
213                    ]
214                },
215                "SensingFrequency": {
216                    "description": "The time interval between readings of the physical leak detector.",
217                    "longDescription": "This property shall contain the time interval between readings of the physical leak detector.",
218                    "readonly": true,
219                    "type": [
220                        "number",
221                        "null"
222                    ]
223                },
224                "SerialNumber": {
225                    "description": "The serial number of the leak detector.",
226                    "longDescription": "This property shall contain a manufacturer-allocated number that identifies the leak detector.",
227                    "readonly": true,
228                    "type": [
229                        "string",
230                        "null"
231                    ]
232                },
233                "SparePartNumber": {
234                    "description": "The spare part number of the leak detector.",
235                    "longDescription": "This property shall contain the spare part number of the leak detector.",
236                    "readonly": true,
237                    "type": [
238                        "string",
239                        "null"
240                    ]
241                },
242                "Status": {
243                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Status",
244                    "description": "The status and health of the resource and its subordinate or dependent resources.",
245                    "longDescription": "This property shall contain any status or health properties of the resource."
246                },
247                "UserLabel": {
248                    "description": "A user-assigned label.",
249                    "longDescription": "This property shall contain a user-assigned label used to identify this resource.  If a value has not been assigned by a user, the value of this property shall be an empty string.",
250                    "readonly": false,
251                    "type": "string",
252                    "versionAdded": "v1_1_0"
253                },
254                "WarningReactionType": {
255                    "$ref": "#/definitions/ReactionType",
256                    "description": "The reaction to perform when a warning-level leak is detected.",
257                    "longDescription": "The reaction that shall be performed when the `DetectorState` property changes to `Warning`.",
258                    "readonly": false,
259                    "versionAdded": "v1_4_0"
260                }
261            },
262            "required": [
263                "@odata.id",
264                "@odata.type",
265                "Id",
266                "Name"
267            ],
268            "type": "object"
269        },
270        "LeakDetectorArrayExcerpt": {
271            "additionalProperties": false,
272            "description": "The `LeakDetector` schema describes a state-based or digital-value leak detector and its properties.",
273            "excerpt": "LeakDetectorArray",
274            "longDescription": "This resource shall represent a state-based or digital-value leak detector for a Redfish implementation.",
275            "patternProperties": {
276                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
277                    "description": "This property shall specify a valid odata or Redfish property.",
278                    "type": [
279                        "array",
280                        "boolean",
281                        "integer",
282                        "number",
283                        "null",
284                        "object",
285                        "string"
286                    ]
287                }
288            },
289            "properties": {
290                "DataSourceUri": {
291                    "description": "The link to the resource that provides the data for this leak detector.",
292                    "excerptCopyOnly": true,
293                    "format": "uri-reference",
294                    "longDescription": "This property shall contain a URI to the resource that provides the source of the excerpt contained within this copy.",
295                    "readonly": true,
296                    "type": [
297                        "string",
298                        "null"
299                    ]
300                },
301                "DetectorState": {
302                    "anyOf": [
303                        {
304                            "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Health"
305                        },
306                        {
307                            "type": "null"
308                        }
309                    ],
310                    "description": "The state of the leak detector.",
311                    "excerpt": "LeakDetector",
312                    "longDescription": "This property shall contain the state of the leak detector.  The value of this property should equate the value of `Health` in `Status`, and was created primarily for use in excerpts of this resource.",
313                    "readonly": true
314                },
315                "DeviceName": {
316                    "description": "The name of the device.",
317                    "excerpt": "LeakDetectorArray",
318                    "excerptCopyOnly": true,
319                    "longDescription": "This property shall contain the name of the device associated with this leak detector.  If the device is represented by a resource, the value shall contain the value of the `Name` property of the associated resource.",
320                    "readonly": true,
321                    "type": [
322                        "string",
323                        "null"
324                    ],
325                    "versionAdded": "v1_2_0"
326                },
327                "PhysicalContext": {
328                    "anyOf": [
329                        {
330                            "$ref": "http://redfish.dmtf.org/schemas/v1/PhysicalContext.json#/definitions/PhysicalContext"
331                        },
332                        {
333                            "type": "null"
334                        }
335                    ],
336                    "description": "The area or device to which this leak detector applies.",
337                    "excerpt": "LeakDetectorArray",
338                    "longDescription": "This property shall contain a description of the affected component or region within the equipment to which this leak detector applies.",
339                    "readonly": true
340                },
341                "PhysicalSubContext": {
342                    "anyOf": [
343                        {
344                            "$ref": "http://redfish.dmtf.org/schemas/v1/PhysicalContext.json#/definitions/PhysicalSubContext"
345                        },
346                        {
347                            "type": "null"
348                        }
349                    ],
350                    "description": "The usage or location within a device to which this leak detector applies.",
351                    "excerpt": "LeakDetectorArray",
352                    "longDescription": "This property shall contain a description of the usage or sub-region within the equipment to which this leak detector applies.  This property generally differentiates multiple leak detectors within the same `PhysicalContext` instance.",
353                    "readonly": true
354                }
355            },
356            "type": "object"
357        },
358        "LeakDetectorExcerpt": {
359            "additionalProperties": false,
360            "description": "The `LeakDetector` schema describes a state-based or digital-value leak detector and its properties.",
361            "excerpt": "LeakDetector",
362            "longDescription": "This resource shall represent a state-based or digital-value leak detector for a Redfish implementation.",
363            "patternProperties": {
364                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
365                    "description": "This property shall specify a valid odata or Redfish property.",
366                    "type": [
367                        "array",
368                        "boolean",
369                        "integer",
370                        "number",
371                        "null",
372                        "object",
373                        "string"
374                    ]
375                }
376            },
377            "properties": {
378                "DataSourceUri": {
379                    "description": "The link to the resource that provides the data for this leak detector.",
380                    "excerptCopyOnly": true,
381                    "format": "uri-reference",
382                    "longDescription": "This property shall contain a URI to the resource that provides the source of the excerpt contained within this copy.",
383                    "readonly": true,
384                    "type": [
385                        "string",
386                        "null"
387                    ]
388                },
389                "DetectorState": {
390                    "anyOf": [
391                        {
392                            "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Health"
393                        },
394                        {
395                            "type": "null"
396                        }
397                    ],
398                    "description": "The state of the leak detector.",
399                    "excerpt": "LeakDetector",
400                    "longDescription": "This property shall contain the state of the leak detector.  The value of this property should equate the value of `Health` in `Status`, and was created primarily for use in excerpts of this resource.",
401                    "readonly": true
402                }
403            },
404            "type": "object"
405        },
406        "LeakDetectorType": {
407            "enum": [
408                "Moisture",
409                "FloatSwitch"
410            ],
411            "enumDescriptions": {
412                "FloatSwitch": "A float switch.",
413                "Moisture": "A moisture sensor."
414            },
415            "type": "string"
416        },
417        "OemActions": {
418            "additionalProperties": true,
419            "description": "The available OEM-specific actions for this resource.",
420            "longDescription": "This type shall contain the available OEM-specific actions for this resource.",
421            "patternProperties": {
422                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
423                    "description": "This property shall specify a valid odata or Redfish property.",
424                    "type": [
425                        "array",
426                        "boolean",
427                        "integer",
428                        "number",
429                        "null",
430                        "object",
431                        "string"
432                    ]
433                }
434            },
435            "properties": {},
436            "type": "object"
437        },
438        "ReactionType": {
439            "enum": [
440                "None",
441                "ForceOff",
442                "GracefulShutdown"
443            ],
444            "enumDescriptions": {
445                "ForceOff": "Forcefully shut down the device, equipment, or system.",
446                "GracefulShutdown": "Gracefully shut down the device, equipment, or system.",
447                "None": "No reaction."
448            },
449            "enumLongDescriptions": {
450                "ForceOff": "This value shall indicate that the associated device, equipment, or system monitored by this leak detector is forcefully shut down when a leak is detected.",
451                "GracefulShutdown": "This value shall indicate that the associated device, equipment, or system monitored by this leak detector is gracefully shut down when a leak is detected.",
452                "None": "This value shall indicate no reaction occurs when a leak is detected."
453            },
454            "type": "string"
455        }
456    },
457    "language": "en",
458    "owningEntity": "DMTF",
459    "release": "2025.2",
460    "title": "#LeakDetector.v1_4_0.LeakDetector"
461}