1{
2    "$id": "http://redfish.dmtf.org/schemas/v1/Storage.v1_16_0.json",
3    "$ref": "#/definitions/Storage",
4    "$schema": "http://redfish.dmtf.org/schemas/v1/redfish-schema-v1.json",
5    "copyright": "Copyright 2014-2024 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                "#Storage.RekeyExternalKey": {
27                    "$ref": "#/definitions/RekeyExternalKey"
28                },
29                "#Storage.ResetToDefaults": {
30                    "$ref": "#/definitions/ResetToDefaults"
31                },
32                "#Storage.SetEncryptionKey": {
33                    "$ref": "#/definitions/SetEncryptionKey"
34                },
35                "Oem": {
36                    "$ref": "#/definitions/OemActions",
37                    "description": "The available OEM-specific actions for this resource.",
38                    "longDescription": "This property shall contain the available OEM-specific actions for this resource."
39                }
40            },
41            "type": "object"
42        },
43        "AutoVolumeCreate": {
44            "enum": [
45                "Disabled",
46                "NonRAID",
47                "RAID0",
48                "RAID1"
49            ],
50            "enumDescriptions": {
51                "Disabled": "Do not automatically create volumes.",
52                "NonRAID": "Automatically create non-RAID volumes.",
53                "RAID0": "Automatically create RAID0 volumes.",
54                "RAID1": "Automatically create RAID1 volumes."
55            },
56            "type": "string"
57        },
58        "CacheSummary": {
59            "additionalProperties": false,
60            "description": "This type describes the cache memory of the storage controller in general detail.",
61            "longDescription": "This type shall contain properties that describe the cache memory for a storage controller.",
62            "patternProperties": {
63                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
64                    "description": "This property shall specify a valid odata or Redfish property.",
65                    "type": [
66                        "array",
67                        "boolean",
68                        "integer",
69                        "number",
70                        "null",
71                        "object",
72                        "string"
73                    ]
74                }
75            },
76            "properties": {
77                "PersistentCacheSizeMiB": {
78                    "description": "The portion of the cache memory that is persistent, measured in MiB.",
79                    "longDescription": "This property shall contain the amount of cache memory that is persistent as measured in mebibytes.  This size shall be less than or equal to the `TotalCacheSizeMiB`.",
80                    "minimum": 0,
81                    "readonly": true,
82                    "type": [
83                        "integer",
84                        "null"
85                    ],
86                    "units": "MiBy",
87                    "versionAdded": "v1_5_0"
88                },
89                "Status": {
90                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Status",
91                    "description": "The status and health of the resource and its subordinate or dependent resources.",
92                    "longDescription": "This property shall contain any status or health properties of the resource.",
93                    "versionAdded": "v1_5_0"
94                },
95                "TotalCacheSizeMiB": {
96                    "description": "The total configured cache memory, measured in MiB.",
97                    "longDescription": "This property shall contain the amount of configured cache memory as measured in mebibytes.",
98                    "minimum": 0,
99                    "readonly": true,
100                    "type": [
101                        "integer",
102                        "null"
103                    ],
104                    "units": "MiBy",
105                    "versionAdded": "v1_5_0"
106                }
107            },
108            "required": [
109                "TotalCacheSizeMiB"
110            ],
111            "type": "object"
112        },
113        "ConfigurationLock": {
114            "enum": [
115                "Enabled",
116                "Disabled",
117                "Partial"
118            ],
119            "enumDescriptions": {
120                "Disabled": "In-band configuration requests are not locked.",
121                "Enabled": "In-band configuration requests are locked.  Configuration requests include applying firmware, updating security keys, and other hardware settings.  It does not include managing the volumes or data within the storage subsystem.",
122                "Partial": "Some in-band configuration requests are not locked while others are locked.  This value is used for status reporting to indicate that the storage subsystem is partially locked and client action is recommended."
123            },
124            "enumLongDescriptions": {
125                "Disabled": "This value shall indicate in-band configuration requests are not locked.",
126                "Enabled": "This value shall indicate in-band configuration requests are locked.",
127                "Partial": "This value shall indicate some in-band configuration requests are not locked while others are locked."
128            },
129            "type": "string"
130        },
131        "EncryptionMode": {
132            "enum": [
133                "Disabled",
134                "UseExternalKey",
135                "UseLocalKey"
136            ],
137            "enumDescriptions": {
138                "Disabled": "Encryption is disabled on the storage subsystem.",
139                "UseExternalKey": "The storage subsystem uses one or more external keys for encryption.",
140                "UseLocalKey": "The storage subsystem uses a local key for encryption."
141            },
142            "type": "string"
143        },
144        "HotspareActivationPolicy": {
145            "enum": [
146                "OnDriveFailure",
147                "OnDrivePredictedFailure",
148                "OEM"
149            ],
150            "enumDescriptions": {
151                "OEM": "The hot spare drive will take over for the original drive in an algorithm custom to the OEM.",
152                "OnDriveFailure": "The hot spare drive will take over for the original drive when the original drive has been marked as failed by the storage domain.",
153                "OnDrivePredictedFailure": "The hot spare drive will take over for the original drive when the original drive has been predicted to fail in the future by the storage domain."
154            },
155            "type": "string"
156        },
157        "Links": {
158            "additionalProperties": false,
159            "description": "The links to other resources that are related to this resource.",
160            "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.",
161            "patternProperties": {
162                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
163                    "description": "This property shall specify a valid odata or Redfish property.",
164                    "type": [
165                        "array",
166                        "boolean",
167                        "integer",
168                        "number",
169                        "null",
170                        "object",
171                        "string"
172                    ]
173                }
174            },
175            "properties": {
176                "Enclosures": {
177                    "description": "An array of links to the chassis to which this storage subsystem is attached.",
178                    "items": {
179                        "$ref": "http://redfish.dmtf.org/schemas/v1/Chassis.json#/definitions/Chassis"
180                    },
181                    "longDescription": "This property shall contain an array of links to resources of type `Chassis` that represent the physical containers attached to this resource.",
182                    "readonly": true,
183                    "type": "array"
184                },
185                "Enclosures@odata.count": {
186                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count"
187                },
188                "HostingStorageSystems": {
189                    "description": "The storage systems that host this storage subsystem.",
190                    "items": {
191                        "$ref": "http://redfish.dmtf.org/schemas/v1/ComputerSystem.json#/definitions/ComputerSystem"
192                    },
193                    "longDescription": "This property shall contain an array of links to resources of type `ComputerSystem` that represent the storage systems that host this storage subsystem.  The members of this array shall be in the `StorageSystems` resource collection off the service root.",
194                    "readonly": true,
195                    "type": "array",
196                    "versionAdded": "v1_11_0"
197                },
198                "HostingStorageSystems@odata.count": {
199                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count"
200                },
201                "NVMeoFDiscoverySubsystems": {
202                    "description": "An array of links to the discovery subsystems that discovered this subsystem in an NVMe-oF environment.",
203                    "items": {
204                        "$ref": "http://redfish.dmtf.org/schemas/v1/Storage.json#/definitions/Storage"
205                    },
206                    "longDescription": "This property shall contain an array of links to resources of type `Storage` that represent the discovery subsystems that discovered this subsystem in an NVMe-oF environment.",
207                    "readonly": true,
208                    "type": "array",
209                    "versionAdded": "v1_15_0"
210                },
211                "NVMeoFDiscoverySubsystems@odata.count": {
212                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count"
213                },
214                "Oem": {
215                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem",
216                    "description": "The OEM extension property.",
217                    "longDescription": "This property shall contain the OEM extensions.  All values for properties contained in this object shall conform to the Redfish Specification-described requirements."
218                },
219                "SimpleStorage": {
220                    "$ref": "http://redfish.dmtf.org/schemas/v1/SimpleStorage.json#/definitions/SimpleStorage",
221                    "description": "The link to the simple storage instance that corresponds to this storage.",
222                    "longDescription": "This property shall contain a link to a resource of type `SimpleStorage` that represents the same storage subsystem as this resource.",
223                    "readonly": true,
224                    "versionAdded": "v1_9_0"
225                },
226                "StorageServices": {
227                    "description": "An array of links to the storage services that connect to this storage subsystem.",
228                    "items": {
229                        "$ref": "http://redfish.dmtf.org/schemas/swordfish/v1/StorageService.json#/definitions/StorageService"
230                    },
231                    "longDescription": "This property shall contain an array of links to resources of type `StorageService` with which this storage subsystem is associated.",
232                    "readonly": true,
233                    "type": "array",
234                    "versionAdded": "v1_9_0"
235                },
236                "StorageServices@odata.count": {
237                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count"
238                }
239            },
240            "type": "object"
241        },
242        "NVMeSubsystemProperties": {
243            "additionalProperties": false,
244            "description": "Information specific to NVMe Subsystems.",
245            "longDescription": "This type shall contain information specific to NVMe Subsystems.",
246            "patternProperties": {
247                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
248                    "description": "This property shall specify a valid odata or Redfish property.",
249                    "type": [
250                        "array",
251                        "boolean",
252                        "integer",
253                        "number",
254                        "null",
255                        "object",
256                        "string"
257                    ]
258                }
259            },
260            "properties": {
261                "MaxNamespacesSupported": {
262                    "description": "The maximum number of namespace attachments supported by this NVMe Subsystem.",
263                    "longDescription": "This property shall contain the maximum number of namespace attachments supported by this NVMe Subsystem.  If no maximum is specified, this property should not be implemented.",
264                    "readonly": true,
265                    "type": [
266                        "number",
267                        "null"
268                    ],
269                    "versionAdded": "v1_16_0"
270                },
271                "SharedNamespaceControllerAttachmentSupported": {
272                    "description": "Indicates whether the subsystem supports shared namespace controller attachment, allowing a shared namespace to be attached concurrently to two or more controllers in an NVMe Subsystem.",
273                    "longDescription": "This property shall indicate whether the subsystem supports shared namespace controller attachment, allowing a shared namespace to be attached concurrently to two or more controllers in an NVMe Subsystem.",
274                    "readonly": true,
275                    "type": [
276                        "boolean",
277                        "null"
278                    ],
279                    "versionAdded": "v1_16_0"
280                }
281            },
282            "type": "object"
283        },
284        "OemActions": {
285            "additionalProperties": true,
286            "description": "The available OEM-specific actions for this resource.",
287            "longDescription": "This type shall contain the available OEM-specific actions for this resource.",
288            "patternProperties": {
289                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
290                    "description": "This property shall specify a valid odata or Redfish property.",
291                    "type": [
292                        "array",
293                        "boolean",
294                        "integer",
295                        "number",
296                        "null",
297                        "object",
298                        "string"
299                    ]
300                }
301            },
302            "properties": {},
303            "type": "object"
304        },
305        "Rates": {
306            "additionalProperties": false,
307            "description": "This type describes the various controller rates used for processes such as volume rebuild or consistency checks.",
308            "longDescription": "This type shall contain all the rate settings available on the controller.",
309            "patternProperties": {
310                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
311                    "description": "This property shall specify a valid odata or Redfish property.",
312                    "type": [
313                        "array",
314                        "boolean",
315                        "integer",
316                        "number",
317                        "null",
318                        "object",
319                        "string"
320                    ]
321                }
322            },
323            "properties": {
324                "ConsistencyCheckRatePercent": {
325                    "description": "The percentage of controller resources used for performing a data consistency check on volumes.",
326                    "longDescription": "This property shall contain the percentage of controller resources used for checking data consistency on volumes.",
327                    "maximum": 100,
328                    "minimum": 0,
329                    "readonly": false,
330                    "type": [
331                        "integer",
332                        "null"
333                    ],
334                    "versionAdded": "v1_7_0"
335                },
336                "RebuildRatePercent": {
337                    "description": "The percentage of controller resources used for rebuilding/repairing volumes.",
338                    "longDescription": "This property shall contain the percentage of controller resources used for rebuilding volumes.",
339                    "maximum": 100,
340                    "minimum": 0,
341                    "readonly": false,
342                    "type": [
343                        "integer",
344                        "null"
345                    ],
346                    "versionAdded": "v1_7_0"
347                },
348                "TransformationRatePercent": {
349                    "description": "The percentage of controller resources used for transforming volumes from one configuration to another.",
350                    "longDescription": "This property shall contain the percentage of controller resources used for transforming volumes.",
351                    "maximum": 100,
352                    "minimum": 0,
353                    "readonly": false,
354                    "type": [
355                        "integer",
356                        "null"
357                    ],
358                    "versionAdded": "v1_7_0"
359                }
360            },
361            "type": "object"
362        },
363        "RekeyExternalKey": {
364            "additionalProperties": false,
365            "description": "This action causes the controllers of the storage subsystem to request new encryption keys managed by an external key service.",
366            "longDescription": "This action shall cause the controllers of the storage subsystem to request new encryption keys managed by an external key service.",
367            "parameters": {},
368            "patternProperties": {
369                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
370                    "description": "This property shall specify a valid odata or Redfish property.",
371                    "type": [
372                        "array",
373                        "boolean",
374                        "integer",
375                        "number",
376                        "null",
377                        "object",
378                        "string"
379                    ]
380                }
381            },
382            "properties": {
383                "target": {
384                    "description": "Link to invoke action",
385                    "format": "uri-reference",
386                    "type": "string"
387                },
388                "title": {
389                    "description": "Friendly action name",
390                    "type": "string"
391                }
392            },
393            "type": "object",
394            "versionAdded": "v1_16_0"
395        },
396        "ResetToDefaults": {
397            "additionalProperties": false,
398            "description": "The reset action resets the storage device to factory defaults.  This can cause the loss of data.",
399            "longDescription": "This action shall reset the storage device.  This action can impact other resources.",
400            "parameters": {
401                "ResetType": {
402                    "$ref": "#/definitions/ResetToDefaultsType",
403                    "description": "The type of reset to defaults.",
404                    "longDescription": "This parameter shall contain the type of reset to defaults.",
405                    "requiredParameter": true
406                }
407            },
408            "patternProperties": {
409                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
410                    "description": "This property shall specify a valid odata or Redfish property.",
411                    "type": [
412                        "array",
413                        "boolean",
414                        "integer",
415                        "number",
416                        "null",
417                        "object",
418                        "string"
419                    ]
420                }
421            },
422            "properties": {
423                "target": {
424                    "description": "Link to invoke action",
425                    "format": "uri-reference",
426                    "type": "string"
427                },
428                "title": {
429                    "description": "Friendly action name",
430                    "type": "string"
431                }
432            },
433            "type": "object",
434            "versionAdded": "v1_11_0"
435        },
436        "ResetToDefaultsType": {
437            "enum": [
438                "ResetAll",
439                "PreserveVolumes"
440            ],
441            "enumDescriptions": {
442                "PreserveVolumes": "Reset all settings to factory defaults but preserve the configured volumes on the controllers.",
443                "ResetAll": "Reset all settings to factory defaults and remove all volumes."
444            },
445            "type": "string"
446        },
447        "SetEncryptionKey": {
448            "additionalProperties": false,
449            "description": "This action sets the local encryption key for the storage subsystem.",
450            "longDescription": "This action shall set the local encryption key for the storage subsystem.",
451            "parameters": {
452                "CurrentEncryptionKey": {
453                    "description": "The current local encryption key on the storage subsystem.",
454                    "longDescription": "This parameter shall contain the current local encryption key on the storage subsystem.  Services may reject the action request if this parameter is not provided.",
455                    "type": "string",
456                    "versionAdded": "v1_14_0"
457                },
458                "EncryptionKey": {
459                    "description": "The local encryption key to set on the storage subsystem.",
460                    "longDescription": "This parameter shall contain the local encryption key to set on the storage subsystem.",
461                    "requiredParameter": true,
462                    "type": "string"
463                },
464                "EncryptionKeyIdentifier": {
465                    "description": "The local encryption key identifier used by the storage subsystem.",
466                    "longDescription": "This property shall contain the local encryption key identifier used by the storage subsystem.",
467                    "type": "string",
468                    "versionAdded": "v1_14_0"
469                }
470            },
471            "patternProperties": {
472                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
473                    "description": "This property shall specify a valid odata or Redfish property.",
474                    "type": [
475                        "array",
476                        "boolean",
477                        "integer",
478                        "number",
479                        "null",
480                        "object",
481                        "string"
482                    ]
483                }
484            },
485            "properties": {
486                "target": {
487                    "description": "Link to invoke action",
488                    "format": "uri-reference",
489                    "type": "string"
490                },
491                "title": {
492                    "description": "Friendly action name",
493                    "type": "string"
494                }
495            },
496            "type": "object"
497        },
498        "Storage": {
499            "additionalProperties": false,
500            "description": "The `Storage` schema defines a storage subsystem and its respective properties.  A storage subsystem represents a set of physical or virtual storage controllers and the resources, such as volumes, that can be accessed from that subsystem.",
501            "longDescription": "This resource shall represent a storage subsystem in the Redfish Specification.",
502            "patternProperties": {
503                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
504                    "description": "This property shall specify a valid odata or Redfish property.",
505                    "type": [
506                        "array",
507                        "boolean",
508                        "integer",
509                        "number",
510                        "null",
511                        "object",
512                        "string"
513                    ]
514                }
515            },
516            "properties": {
517                "@odata.context": {
518                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/context"
519                },
520                "@odata.etag": {
521                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/etag"
522                },
523                "@odata.id": {
524                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/id"
525                },
526                "@odata.type": {
527                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/type"
528                },
529                "Actions": {
530                    "$ref": "#/definitions/Actions",
531                    "description": "The available actions for this resource.",
532                    "longDescription": "This property shall contain the available actions for this resource."
533                },
534                "AutoVolumeCreate": {
535                    "anyOf": [
536                        {
537                            "$ref": "#/definitions/AutoVolumeCreate"
538                        },
539                        {
540                            "type": "null"
541                        }
542                    ],
543                    "description": "Indicates if this storage subsystem automatically creates new volumes for unassigned drives.",
544                    "longDescription": "This property shall indicate if volumes are created automatically for each unassigned drive attached to this storage subsystem.",
545                    "readonly": false,
546                    "versionAdded": "v1_15_0"
547                },
548                "ConfigurationLock": {
549                    "anyOf": [
550                        {
551                            "$ref": "#/definitions/ConfigurationLock"
552                        },
553                        {
554                            "type": "null"
555                        }
556                    ],
557                    "description": "Indicates whether in-band configuration requests to the storage subsystem are locked.",
558                    "longDescription": "This property shall indicate whether configuration requests to the storage subsystem are locked.  Services shall reject modification requests that contain the value `Partial`.  Modifying the value of this property may affect the `ConfigurationLock` property in `Drive` resources referenced by the `Drives` property.",
559                    "readonly": false,
560                    "versionAdded": "v1_16_0"
561                },
562                "Connections": {
563                    "$ref": "http://redfish.dmtf.org/schemas/v1/ConnectionCollection.json#/definitions/ConnectionCollection",
564                    "description": "The collection of links to the connections that this storage subsystem contains.",
565                    "longDescription": "This property shall contain a link to a resource collection of type `ConnectionCollection`.  The members of this collection shall reference Connection resources subordinate to Fabric resources.",
566                    "readonly": true,
567                    "versionAdded": "v1_15_0"
568                },
569                "ConsistencyGroups": {
570                    "$ref": "http://redfish.dmtf.org/schemas/swordfish/v1/ConsistencyGroupCollection.json#/definitions/ConsistencyGroupCollection",
571                    "description": "The consistency groups, each of which contains a set of volumes that are treated by an application or set of applications as a single resource, that are managed by this storage subsystem.",
572                    "longDescription": "This property shall contain a link to a resource collection of type `ConsistencyGroupCollection`.  The property shall be used when groups of volumes are treated as a single resource by an application or set of applications.",
573                    "readonly": true,
574                    "versionAdded": "v1_8_0"
575                },
576                "Controllers": {
577                    "$ref": "http://redfish.dmtf.org/schemas/v1/StorageControllerCollection.json#/definitions/StorageControllerCollection",
578                    "description": "The set of controllers instantiated by this storage subsystem.",
579                    "longDescription": "This property shall contain a link to a resource collection of type `StorageControllerCollection` that contains the set of storage controllers allocated to this storage subsystem.",
580                    "readonly": true,
581                    "versionAdded": "v1_9_0"
582                },
583                "Description": {
584                    "anyOf": [
585                        {
586                            "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Description"
587                        },
588                        {
589                            "type": "null"
590                        }
591                    ],
592                    "readonly": true
593                },
594                "Drives": {
595                    "description": "The set of drives attached to the storage controllers that this resource represents.",
596                    "items": {
597                        "$ref": "http://redfish.dmtf.org/schemas/v1/Drive.json#/definitions/Drive"
598                    },
599                    "longDescription": "This property shall contain a set of the drives attached to the storage controllers that this resource represents.",
600                    "readonly": true,
601                    "type": "array"
602                },
603                "Drives@odata.count": {
604                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count"
605                },
606                "EncryptionMode": {
607                    "anyOf": [
608                        {
609                            "$ref": "#/definitions/EncryptionMode"
610                        },
611                        {
612                            "type": "null"
613                        }
614                    ],
615                    "description": "The encryption mode of this storage subsystem.",
616                    "longDescription": "This property shall contain the encryption mode of this storage subsystem.",
617                    "readonly": false,
618                    "versionAdded": "v1_14_0"
619                },
620                "EndpointGroups": {
621                    "$ref": "http://redfish.dmtf.org/schemas/v1/EndpointGroupCollection.json#/definitions/EndpointGroupCollection",
622                    "description": "All of the endpoint groups, each of which contains a set of endpoints that are used for a common purpose such as an ACL or logical identification, that belong to this storage subsystem.",
623                    "longDescription": "This property shall contain a link to a resource collection of type `EndpointGroupCollection`.  This property shall be implemented when atomic control is needed to perform mapping, masking, and zoning operations.",
624                    "readonly": true,
625                    "versionAdded": "v1_8_0"
626                },
627                "FileSystems": {
628                    "$ref": "http://redfish.dmtf.org/schemas/swordfish/v1/FileSystemCollection.json#/definitions/FileSystemCollection",
629                    "description": "All file systems that are allocated by this storage subsystem.",
630                    "longDescription": "This property shall contain a link to a resource collection of type `FileSystemCollection`.  This property shall be used when file systems are shared or exported by the storage subsystem.",
631                    "readonly": true,
632                    "versionAdded": "v1_8_0"
633                },
634                "HotspareActivationPolicy": {
635                    "anyOf": [
636                        {
637                            "$ref": "#/definitions/HotspareActivationPolicy"
638                        },
639                        {
640                            "type": "null"
641                        }
642                    ],
643                    "description": "The policy under which hot spare drives in this storage domain will activate.",
644                    "longDescription": "This property shall contain the policy under which all drives operating as hot spares in this storage domain will activate.",
645                    "readonly": false,
646                    "versionAdded": "v1_14_0"
647                },
648                "Id": {
649                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Id",
650                    "readonly": true
651                },
652                "Identifiers": {
653                    "description": "The durable names for the storage subsystem.",
654                    "items": {
655                        "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Identifier"
656                    },
657                    "longDescription": "This property shall contain a list of all known durable names for the storage subsystem.",
658                    "type": "array",
659                    "versionAdded": "v1_9_0"
660                },
661                "Links": {
662                    "$ref": "#/definitions/Links",
663                    "description": "The links to other resources that are related to this resource.",
664                    "longDescription": "This property shall contain links to resources that are related to but are not contained by, or subordinate to, this resource."
665                },
666                "LocalEncryptionKeyIdentifier": {
667                    "description": "The local encryption key identifier used by the storage subsystem.",
668                    "longDescription": "This property shall contain the local encryption key identifier used by the storage subsystem when `EncryptionMode` contains `UseLocalKey`.",
669                    "readonly": true,
670                    "type": [
671                        "string",
672                        "null"
673                    ],
674                    "versionAdded": "v1_14_0"
675                },
676                "NVMeSubsystemProperties": {
677                    "anyOf": [
678                        {
679                            "$ref": "#/definitions/NVMeSubsystemProperties"
680                        },
681                        {
682                            "type": "null"
683                        }
684                    ],
685                    "description": "Information specific to NVMe Subsystems.",
686                    "longDescription": "This property shall contain information specific to NVMe Subsystems.  This property shall only be present if this resource represents an NVMe Subsystem.",
687                    "versionAdded": "v1_16_0"
688                },
689                "Name": {
690                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Name",
691                    "readonly": true
692                },
693                "Oem": {
694                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem",
695                    "description": "The OEM extension property.",
696                    "longDescription": "This property shall contain the OEM extensions.  All values for properties that this object contains shall conform to the Redfish Specification-described requirements."
697                },
698                "Redundancy": {
699                    "autoExpand": true,
700                    "description": "Redundancy information for the storage subsystem.",
701                    "items": {
702                        "$ref": "http://redfish.dmtf.org/schemas/v1/Redundancy.json#/definitions/Redundancy"
703                    },
704                    "longDescription": "This property shall contain redundancy information for the storage subsystem.",
705                    "type": "array"
706                },
707                "Redundancy@odata.count": {
708                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count"
709                },
710                "Status": {
711                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Status",
712                    "description": "The status and health of the resource and its subordinate or dependent resources.",
713                    "longDescription": "This property shall contain any status or health properties of the resource."
714                },
715                "StorageControllers": {
716                    "autoExpand": true,
717                    "deprecated": "This property has been deprecated in favor of `Controllers` to allow for storage controllers to be represented as their own resources.",
718                    "description": "The set of storage controllers that this resource represents.",
719                    "items": {
720                        "$ref": "#/definitions/StorageController"
721                    },
722                    "longDescription": "This property shall contain a set of the storage controllers that this resource represents.",
723                    "readonly": true,
724                    "type": "array",
725                    "versionDeprecated": "v1_13_0"
726                },
727                "StorageControllers@odata.count": {
728                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count"
729                },
730                "StorageGroups": {
731                    "$ref": "http://redfish.dmtf.org/schemas/swordfish/v1/StorageGroupCollection.json#/definitions/StorageGroupCollection",
732                    "deprecated": "This property was deprecated in favor of the `Connections` property.",
733                    "description": "All of the storage groups, each of which contains a set of volumes and endpoints that are managed as a group for mapping and masking, that belong to this storage subsystem.",
734                    "longDescription": "This property shall contain a link to a resource collection of type `StorageGroupsCollection`.  This property shall be used when implementing mapping and masking.",
735                    "readonly": true,
736                    "versionAdded": "v1_8_0",
737                    "versionDeprecated": "v1_15_0"
738                },
739                "StoragePools": {
740                    "$ref": "http://redfish.dmtf.org/schemas/swordfish/v1/StoragePoolCollection.json#/definitions/StoragePoolCollection",
741                    "description": "The set of all storage pools that are allocated by this storage subsystem.  A storage pool is the set of storage capacity that can be used to produce volumes or other storage pools.",
742                    "longDescription": "This property shall contain a link to a resource collection of type `StoragePoolCollection`.  This property shall be used when an abstraction of media, rather than references to individual media, are used as the storage data source.",
743                    "readonly": true,
744                    "versionAdded": "v1_8_0"
745                },
746                "Volumes": {
747                    "$ref": "http://redfish.dmtf.org/schemas/swordfish/v1/VolumeCollection.json#/definitions/VolumeCollection",
748                    "description": "The set of volumes that the storage controllers produce.",
749                    "longDescription": "This property shall contain a link to a resource collection of type `VolumeCollection`.",
750                    "readonly": true
751                }
752            },
753            "required": [
754                "@odata.id",
755                "@odata.type",
756                "Id",
757                "Name"
758            ],
759            "type": "object"
760        },
761        "StorageController": {
762            "additionalProperties": false,
763            "description": "The StorageController schema describes a storage controller and its properties.  A storage controller represents a physical or virtual storage device that produces volumes.",
764            "longDescription": "This resource shall represent a storage controller in the Redfish Specification.",
765            "patternProperties": {
766                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
767                    "description": "This property shall specify a valid odata or Redfish property.",
768                    "type": [
769                        "array",
770                        "boolean",
771                        "integer",
772                        "number",
773                        "null",
774                        "object",
775                        "string"
776                    ]
777                }
778            },
779            "properties": {
780                "@odata.id": {
781                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/id"
782                },
783                "Actions": {
784                    "$ref": "#/definitions/StorageControllerActions",
785                    "description": "The available actions for this resource.",
786                    "longDescription": "This property shall contain the available actions for this resource.",
787                    "versionAdded": "v1_2_0"
788                },
789                "Assembly": {
790                    "$ref": "http://redfish.dmtf.org/schemas/v1/Assembly.json#/definitions/Assembly",
791                    "description": "The link to the assembly associated with this storage controller.",
792                    "longDescription": "This property shall contain a link to a resource of type `Assembly`.",
793                    "readonly": true,
794                    "versionAdded": "v1_4_0"
795                },
796                "AssetTag": {
797                    "description": "The user-assigned asset tag for this storage controller.",
798                    "longDescription": "This property shall track the storage controller for inventory purposes.",
799                    "readonly": false,
800                    "type": [
801                        "string",
802                        "null"
803                    ]
804                },
805                "CacheSummary": {
806                    "$ref": "#/definitions/CacheSummary",
807                    "description": "The cache memory of the storage controller in general detail.",
808                    "longDescription": "This property shall contain properties that describe the cache memory for this resource.",
809                    "versionAdded": "v1_5_0"
810                },
811                "Certificates": {
812                    "$ref": "http://redfish.dmtf.org/schemas/v1/CertificateCollection.json#/definitions/CertificateCollection",
813                    "description": "The link to a collection of certificates for device identity and attestation.",
814                    "longDescription": "This property shall contain a link to a resource collection of type `CertificateCollection` that contains certificates for device identity and attestation.",
815                    "readonly": true,
816                    "versionAdded": "v1_10_0"
817                },
818                "ControllerRates": {
819                    "$ref": "#/definitions/Rates",
820                    "description": "This property describes the various controller rates used for processes such as volume rebuild or consistency checks.",
821                    "longDescription": "This object shall contain all the rate settings available on the controller.",
822                    "versionAdded": "v1_7_0"
823                },
824                "FirmwareVersion": {
825                    "description": "The firmware version of this storage controller.",
826                    "longDescription": "This property shall contain the firmware version as defined by the manufacturer for the associated storage controller.",
827                    "readonly": true,
828                    "type": [
829                        "string",
830                        "null"
831                    ]
832                },
833                "Identifiers": {
834                    "description": "The durable names for the storage controller.",
835                    "items": {
836                        "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Identifier"
837                    },
838                    "longDescription": "This property shall contain a list of all known durable names for the associated storage controller.",
839                    "type": "array"
840                },
841                "Links": {
842                    "$ref": "#/definitions/StorageControllerLinks",
843                    "description": "The links to other resources that are related to this resource.",
844                    "longDescription": "This property shall contain links to resources that are related to but are not contained by, or subordinate to, this resource.",
845                    "versionAdded": "v1_1_0"
846                },
847                "Location": {
848                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Location",
849                    "description": "The location of the storage controller.",
850                    "longDescription": "This property shall contain the location information of the associated storage controller.",
851                    "versionAdded": "v1_4_0"
852                },
853                "Manufacturer": {
854                    "description": "The manufacturer of this storage controller.",
855                    "longDescription": "This property shall contain the name of the organization responsible for producing the storage controller.  This organization may be the entity from which the storage controller is purchased, but this is not necessarily true.",
856                    "readonly": true,
857                    "type": [
858                        "string",
859                        "null"
860                    ]
861                },
862                "Measurements": {
863                    "deprecated": "This property has been deprecated in favor of the `ComponentIntegrity` resource.",
864                    "description": "An array of DSP0274-defined measurement blocks.",
865                    "items": {
866                        "$ref": "http://redfish.dmtf.org/schemas/v1/SoftwareInventory.json#/definitions/MeasurementBlock"
867                    },
868                    "longDescription": "This property shall contain an array of DSP0274-defined measurement blocks.",
869                    "type": "array",
870                    "versionAdded": "v1_10_0",
871                    "versionDeprecated": "v1_12_0"
872                },
873                "MemberId": {
874                    "description": "The unique identifier for the member within an array.",
875                    "longDescription": "This property shall contain the unique identifier for this member within an array.  For services supporting Redfish v1.6 or higher, this value shall contain the zero-based array index.",
876                    "readonly": true,
877                    "type": "string"
878                },
879                "Model": {
880                    "description": "The model number for the storage controller.",
881                    "longDescription": "This property shall contain the name by which the manufacturer generally refers to the storage controller.",
882                    "readonly": true,
883                    "type": [
884                        "string",
885                        "null"
886                    ]
887                },
888                "Name": {
889                    "description": "The name of the storage controller.",
890                    "longDescription": "This property shall contain the name of the storage controller.",
891                    "readonly": true,
892                    "type": [
893                        "string",
894                        "null"
895                    ],
896                    "versionAdded": "v1_3_0"
897                },
898                "Oem": {
899                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem",
900                    "description": "The OEM extension property.",
901                    "longDescription": "This property shall contain the OEM extensions.  All values for properties that this object contains shall conform to the Redfish Specification-described requirements."
902                },
903                "PCIeInterface": {
904                    "$ref": "http://redfish.dmtf.org/schemas/v1/PCIeDevice.json#/definitions/PCIeInterface",
905                    "description": "The PCIe interface details for this controller.",
906                    "longDescription": "This property shall contain details on the PCIe interface that connects this PCIe-based controller to its host.",
907                    "versionAdded": "v1_5_0"
908                },
909                "PartNumber": {
910                    "description": "The part number for this storage controller.",
911                    "longDescription": "This property shall contain a part number assigned by the organization that is responsible for producing or manufacturing the storage controller.",
912                    "readonly": true,
913                    "type": [
914                        "string",
915                        "null"
916                    ]
917                },
918                "Ports": {
919                    "$ref": "http://redfish.dmtf.org/schemas/v1/PortCollection.json#/definitions/PortCollection",
920                    "description": "The link to the collection of ports that exist on the storage controller.",
921                    "longDescription": "This property shall contain a link to a resource collection of type `PortCollection`.",
922                    "readonly": true,
923                    "versionAdded": "v1_7_0"
924                },
925                "SKU": {
926                    "description": "The SKU for this storage controller.",
927                    "longDescription": "This property shall contain the stock-keeping unit number for this storage controller.",
928                    "readonly": true,
929                    "type": [
930                        "string",
931                        "null"
932                    ]
933                },
934                "SerialNumber": {
935                    "description": "The serial number for this storage controller.",
936                    "longDescription": "This property shall contain a manufacturer-allocated number that identifies the storage controller.",
937                    "readonly": true,
938                    "type": [
939                        "string",
940                        "null"
941                    ]
942                },
943                "SpeedGbps": {
944                    "description": "The maximum speed of the storage controller's device interface.",
945                    "longDescription": "This property shall represent the maximum supported speed of the storage bus interface, in Gbit/s.  The specified interface connects the controller to the storage devices, not the controller to a host.  For example, SAS bus not PCIe host bus.",
946                    "minimum": 0,
947                    "readonly": true,
948                    "type": [
949                        "number",
950                        "null"
951                    ],
952                    "units": "Gbit/s"
953                },
954                "Status": {
955                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Status",
956                    "description": "The status and health of the resource and its subordinate or dependent resources.",
957                    "longDescription": "This property shall contain any status or health properties of the resource."
958                },
959                "SupportedControllerProtocols": {
960                    "description": "The supported set of protocols for communicating with this storage controller.",
961                    "items": {
962                        "$ref": "http://redfish.dmtf.org/schemas/v1/Protocol.json#/definitions/Protocol"
963                    },
964                    "longDescription": "This property shall contain the supported set of protocols for communicating with this storage controller.",
965                    "readonly": true,
966                    "type": "array"
967                },
968                "SupportedDeviceProtocols": {
969                    "description": "The protocols that the storage controller can use to communicate with attached devices.",
970                    "items": {
971                        "$ref": "http://redfish.dmtf.org/schemas/v1/Protocol.json#/definitions/Protocol"
972                    },
973                    "longDescription": "This property shall contain the set of protocols this storage controller can use to communicate with attached devices.",
974                    "readonly": true,
975                    "type": "array"
976                },
977                "SupportedRAIDTypes": {
978                    "description": "The set of RAID types supported by the storage controller.",
979                    "items": {
980                        "anyOf": [
981                            {
982                                "$ref": "http://redfish.dmtf.org/schemas/swordfish/v1/Volume.json#/definitions/RAIDType"
983                            },
984                            {
985                                "type": "null"
986                            }
987                        ]
988                    },
989                    "longDescription": "This property shall contain an array of all the RAID types supported by this controller.",
990                    "readonly": true,
991                    "type": "array",
992                    "versionAdded": "v1_6_0"
993                }
994            },
995            "required": [
996                "@odata.id",
997                "MemberId"
998            ],
999            "type": "object"
1000        },
1001        "StorageControllerActions": {
1002            "additionalProperties": false,
1003            "description": "The available actions for this resource.",
1004            "longDescription": "This type shall contain the available actions for this resource.",
1005            "patternProperties": {
1006                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
1007                    "description": "This property shall specify a valid odata or Redfish property.",
1008                    "type": [
1009                        "array",
1010                        "boolean",
1011                        "integer",
1012                        "number",
1013                        "null",
1014                        "object",
1015                        "string"
1016                    ]
1017                }
1018            },
1019            "properties": {
1020                "Oem": {
1021                    "$ref": "#/definitions/StorageControllerOemActions",
1022                    "description": "The available OEM-specific actions for this resource.",
1023                    "longDescription": "This property shall contain the available OEM-specific actions for this resource.",
1024                    "versionAdded": "v1_2_0"
1025                }
1026            },
1027            "type": "object"
1028        },
1029        "StorageControllerLinks": {
1030            "additionalProperties": false,
1031            "description": "The links to other resources that are related to this resource.",
1032            "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.",
1033            "patternProperties": {
1034                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
1035                    "description": "This property shall specify a valid odata or Redfish property.",
1036                    "type": [
1037                        "array",
1038                        "boolean",
1039                        "integer",
1040                        "number",
1041                        "null",
1042                        "object",
1043                        "string"
1044                    ]
1045                }
1046            },
1047            "properties": {
1048                "Endpoints": {
1049                    "description": "An array of links to the endpoints that connect to this controller.",
1050                    "items": {
1051                        "$ref": "http://redfish.dmtf.org/schemas/v1/Endpoint.json#/definitions/Endpoint"
1052                    },
1053                    "longDescription": "This property shall contain an array of links to resources of type `Endpoint` with which this controller is associated.",
1054                    "type": "array",
1055                    "versionAdded": "v1_1_0"
1056                },
1057                "Endpoints@odata.count": {
1058                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count"
1059                },
1060                "Oem": {
1061                    "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem",
1062                    "description": "The OEM extension property.",
1063                    "longDescription": "This property shall contain the OEM extensions.  All values for properties contained in this object shall conform to the Redfish Specification-described requirements."
1064                },
1065                "PCIeFunctions": {
1066                    "description": "An array of links to the PCIe functions that the storage controller produces.",
1067                    "items": {
1068                        "$ref": "http://redfish.dmtf.org/schemas/v1/PCIeFunction.json#/definitions/PCIeFunction"
1069                    },
1070                    "longDescription": "This property shall contain an array of links to resources of type `PCIeFunction` that represent the PCIe functions associated with this resource.",
1071                    "type": "array",
1072                    "versionAdded": "v1_7_0"
1073                },
1074                "PCIeFunctions@odata.count": {
1075                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count"
1076                },
1077                "StorageServices": {
1078                    "deprecated": "This property has been deprecated in favor of `StorageServices` within the `Links` property at the root level.",
1079                    "description": "An array of links to the storage services that connect to this controller.",
1080                    "items": {
1081                        "$ref": "http://redfish.dmtf.org/schemas/swordfish/v1/StorageService.json#/definitions/StorageService"
1082                    },
1083                    "longDescription": "This property shall contain an array of links to resources of type `StorageService` with which this controller is associated.",
1084                    "type": "array",
1085                    "versionAdded": "v1_4_0",
1086                    "versionDeprecated": "v1_9_0"
1087                },
1088                "StorageServices@odata.count": {
1089                    "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count"
1090                }
1091            },
1092            "type": "object"
1093        },
1094        "StorageControllerOemActions": {
1095            "additionalProperties": true,
1096            "description": "The available OEM-specific actions for this resource.",
1097            "longDescription": "This type shall contain the available OEM-specific actions for this resource.",
1098            "patternProperties": {
1099                "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
1100                    "description": "This property shall specify a valid odata or Redfish property.",
1101                    "type": [
1102                        "array",
1103                        "boolean",
1104                        "integer",
1105                        "number",
1106                        "null",
1107                        "object",
1108                        "string"
1109                    ]
1110                }
1111            },
1112            "properties": {},
1113            "type": "object"
1114        }
1115    },
1116    "language": "en",
1117    "owningEntity": "DMTF",
1118    "release": "2024.1",
1119    "title": "#Storage.v1_16_0.Storage"
1120}