{ "$id": "http://redfish.dmtf.org/schemas/v1/Drive.v1_22_0.json", "$ref": "#/definitions/Drive", "$schema": "http://redfish.dmtf.org/schemas/v1/redfish-schema-v1.json", "copyright": "Copyright 2014-2025 DMTF. For the full DMTF copyright policy, see http://www.dmtf.org/about/policies/copyright", "definitions": { "Actions": { "additionalProperties": false, "description": "The available actions for this resource.", "longDescription": "This type shall contain the available actions for this resource.", "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "#Drive.FreezePersonality": { "$ref": "#/definitions/FreezePersonality" }, "#Drive.GetPersonalityNonce": { "$ref": "#/definitions/GetPersonalityNonce" }, "#Drive.Reset": { "$ref": "#/definitions/Reset" }, "#Drive.RevertPersonalitiesToDefaults": { "$ref": "#/definitions/RevertPersonalitiesToDefaults" }, "#Drive.RevertToOriginalFactoryState": { "$ref": "#/definitions/RevertToOriginalFactoryState" }, "#Drive.SecureErase": { "$ref": "#/definitions/SecureErase" }, "#Drive.SetPersonalityKey": { "$ref": "#/definitions/SetPersonalityKey" }, "#Drive.UnfreezePersonality": { "$ref": "#/definitions/UnfreezePersonality" }, "Oem": { "$ref": "#/definitions/OemActions", "description": "The available OEM-specific actions for this resource.", "longDescription": "This property shall contain the available OEM-specific actions for this resource." } }, "type": "object" }, "ConfigLockOptions": { "enum": [ "Unlocked", "Locked", "LockdownUnsupported", "CommandUnsupported" ], "enumDescriptions": { "CommandUnsupported": "The command is not supported, therefore lockdown does not apply.", "LockdownUnsupported": "The command is supported but is not able to be locked.", "Locked": "The command is supported and is currently locked.", "Unlocked": "The command is supported, able to be locked, and is currently unlocked." }, "type": "string" }, "ConfigurationLock": { "enum": [ "Enabled", "Disabled", "Partial" ], "enumDescriptions": { "Disabled": "In-band configuration requests are not locked.", "Enabled": "In-band configuration requests are locked as specified by `TargetConfigurationLockLevel`.", "Partial": "Some in-band configuration requests are not locked while others are locked. This value is used for status reporting to indicate that the drive is partially locked and client action is recommended." }, "enumLongDescriptions": { "Disabled": "This value shall indicate in-band configuration requests are not locked.", "Enabled": "This value shall indicate in-band configuration requests are locked as specified by `TargetConfigurationLockLevel`.", "Partial": "This value shall indicate some in-band configuration requests are not locked while others are locked." }, "type": "string" }, "DataSanitizationType": { "enum": [ "BlockErase", "CryptographicErase", "Overwrite" ], "enumDescriptions": { "BlockErase": "Delete all logical block addresses, including those that are not currently mapping to active addresses, but leaving the data on the drive.", "CryptographicErase": "Erase the target data's encryption key leaving only the ciphertext on the drive. For more information, see NIST800-88 and ISO/IEC 27040.", "Overwrite": "Overwrite data by writing an implementation-specific pattern onto all sectors of the drive." }, "enumLongDescriptions": { "BlockErase": "This value shall indicate sanitization is performed by deleting all logical block addresses, including those that are not currently mapping to active addresses, but leaving the data on the drive.", "CryptographicErase": "This value shall indicate sanitization is performed by erasing the target data's encryption key leaving only the ciphertext on the drive. For more information, see NIST800-88 and ISO/IEC 27040.", "Overwrite": "This value shall indicate sanitization is performed by overwriting data by writing an implementation-specific pattern onto all sectors of the drive." }, "type": "string" }, "Drive": { "additionalProperties": false, "description": "The `Drive` schema represents a single physical drive for a system, including links to associated volumes. It also describes the location, such as a slot, socket, or bay, where a unit can be installed, by populating a resource instance with an absent state if a unit is not present.", "longDescription": "This resource shall represent a drive or other physical storage medium for a Redfish implementation. It may also represent a location, such as a slot, socket, or bay, where a unit may be installed, but the `State` property within the `Status` property contains `Absent`.", "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "@odata.context": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/context" }, "@odata.etag": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/etag" }, "@odata.id": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/id" }, "@odata.type": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/type" }, "Actions": { "$ref": "#/definitions/Actions", "description": "The available actions for this resource.", "longDescription": "This property shall contain the available actions for this resource." }, "Assembly": { "$ref": "http://redfish.dmtf.org/schemas/v1/Assembly.json#/definitions/Assembly", "description": "The link to the assembly associated with this drive.", "longDescription": "This property shall contain a link to a resource of type `Assembly`.", "readonly": true, "versionAdded": "v1_3_0" }, "AssetTag": { "description": "The user-assigned asset tag for this drive.", "longDescription": "This property shall track the drive for inventory purposes.", "readonly": false, "type": [ "string", "null" ] }, "BlockSecurityIDEnabled": { "description": "Indicates if establishment of a TCG-defined security ID (SID) on the drive is blocked.", "longDescription": "This property shall indicate if establishment of a TCG-defined security ID (SID) on the drive is blocked. The value `true` shall indicate the TCG-defined 'Block SID' command is sent to the drive during each drive boot sequence.", "readonly": false, "type": [ "boolean", "null" ], "versionAdded": "v1_20_0" }, "BlockSizeBytes": { "description": "The size, in bytes, of the smallest addressable unit, or block.", "longDescription": "This property shall contain the size of the smallest addressable unit of the associated drive.", "readonly": true, "type": [ "integer", "null" ], "units": "By" }, "CapableSpeedGbs": { "description": "The speed, in gigabits per second (Gbit/s) units, at which this drive can communicate to a storage controller in ideal conditions.", "longDescription": "This property shall contain fastest capable bus speed, in gigabits per second (Gbit/s) units, of the associated drive.", "readonly": true, "type": [ "number", "null" ], "units": "Gbit/s" }, "CapacityBytes": { "description": "The size, in bytes, of this drive.", "longDescription": "This property shall contain the raw size, in bytes, of the associated drive.", "readonly": true, "type": [ "integer", "null" ], "units": "By" }, "Certificates": { "$ref": "http://redfish.dmtf.org/schemas/v1/CertificateCollection.json#/definitions/CertificateCollection", "description": "The link to a collection of certificates for device identity and attestation.", "longDescription": "This property shall contain a link to a resource collection of type `CertificateCollection` that contains certificates for device identity and attestation.", "readonly": true, "versionAdded": "v1_12_0" }, "ConfigurationLock": { "anyOf": [ { "$ref": "#/definitions/ConfigurationLock" }, { "type": "null" } ], "description": "Indicates whether in-band configuration requests to the drive are locked. Other properties, such as `ConfigurationLockState`, contain additional information regarding the status of the configuration lock.", "longDescription": "This property shall indicate whether configuration requests to the drive are locked. Services shall reject modification requests that contain the value `Partial`.", "readonly": false, "versionAdded": "v1_19_0" }, "Description": { "anyOf": [ { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Description" }, { "type": "null" } ], "readonly": true }, "DriveFormFactor": { "anyOf": [ { "$ref": "#/definitions/FormFactor" }, { "type": "null" } ], "description": "The form factor of the drive inserted in this slot.", "longDescription": "This property shall contain the form factor of the drive inserted in this slot.", "readonly": true, "versionAdded": "v1_16_0" }, "EncryptionAbility": { "anyOf": [ { "$ref": "#/definitions/EncryptionAbility" }, { "type": "null" } ], "description": "The encryption ability of this drive.", "longDescription": "This property shall contain the encryption ability for the associated drive.", "readonly": true }, "EncryptionStatus": { "anyOf": [ { "$ref": "#/definitions/EncryptionStatus" }, { "type": "null" } ], "description": "The status of the encryption of this drive.", "longDescription": "This property shall contain the encryption status for the associated drive.", "readonly": true }, "EnvironmentMetrics": { "$ref": "http://redfish.dmtf.org/schemas/v1/EnvironmentMetrics.json#/definitions/EnvironmentMetrics", "description": "The link to the environment metrics for this drive.", "longDescription": "This property shall contain a link to a resource of type `EnvironmentMetrics` that specifies the environment metrics for this drive.", "readonly": true, "versionAdded": "v1_12_0" }, "FailurePredicted": { "description": "An indication of whether this drive currently predicts a failure in the near future.", "longDescription": "This property shall indicate whether this drive currently predicts a manufacturer-defined failure.", "readonly": true, "type": [ "boolean", "null" ] }, "FirmwareVersion": { "description": "The firmware version for this drive.", "longDescription": "This property shall contain the firmware version as defined by the manufacturer for this drive.", "readonly": true, "type": [ "string", "null" ], "versionAdded": "v1_17_0" }, "HardwareVersion": { "description": "The hardware version of this drive.", "longDescription": "This property shall contain the hardware version of this drive as determined by the vendor or supplier.", "readonly": true, "type": [ "string", "null" ], "versionAdded": "v1_21_0" }, "HotspareReplacementMode": { "anyOf": [ { "$ref": "#/definitions/HotspareReplacementModeType" }, { "type": "null" } ], "description": "The replacement mode for the hot spare drive.", "longDescription": "This property shall indicate whether a commissioned hot spare continues to serve as a hot spare after the failed drive is replaced.", "readonly": false, "versionAdded": "v1_5_0" }, "HotspareType": { "anyOf": [ { "$ref": "#/definitions/HotspareType" }, { "type": "null" } ], "description": "The type of hot spare that this drive serves as.", "longDescription": "This property shall contain the hot spare type for the associated drive. If the drive currently serves as a hot spare, the `State` property in `Status` shall contain `StandbySpare` and `Enabled` when it is part of a volume.", "readonly": false }, "Id": { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Id", "readonly": true }, "Identifiers": { "description": "The durable names for the drive.", "items": { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Identifier" }, "longDescription": "This property shall contain a list of all known durable names for the associated drive.", "type": "array" }, "IndicatorLED": { "anyOf": [ { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/IndicatorLED" }, { "type": "null" } ], "deprecated": "This property has been deprecated in favor of the `LocationIndicatorActive` property.", "description": "The state of the indicator LED, that identifies the drive.", "longDescription": "This property shall contain the state for the indicator light associated with this drive.", "readonly": false, "versionDeprecated": "v1_11_0" }, "Links": { "$ref": "#/definitions/Links", "description": "The links to other resources that are related to this resource.", "longDescription": "This property shall contain links to resources that are related to but are not contained by, or subordinate to, this resource." }, "Location": { "deprecated": "This property has been deprecated in favor of the singular `PhysicalLocation` property.", "description": "The location of the drive.", "items": { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Location" }, "longDescription": "This property shall contain the location information of the associated drive.", "type": "array", "versionDeprecated": "v1_4_0" }, "LocationIndicatorActive": { "description": "An indicator allowing an operator to physically locate this resource.", "longDescription": "This property shall contain the state of the indicator used to physically identify or locate this resource. A write to this property shall update the value of `IndicatorLED` in this resource, if supported, to reflect the implementation of the locating function.", "readonly": false, "type": [ "boolean", "null" ], "versionAdded": "v1_11_0" }, "Manufacturer": { "description": "The manufacturer of this drive.", "longDescription": "This property shall contain the name of the organization responsible for producing the drive. This organization may be the entity from whom the drive is purchased, but this is not necessarily true.", "readonly": true, "type": [ "string", "null" ] }, "Measurements": { "deprecated": "This property has been deprecated in favor of the `ComponentIntegrity` resource.", "description": "An array of DSP0274-defined measurement blocks.", "items": { "$ref": "http://redfish.dmtf.org/schemas/v1/SoftwareInventory.json#/definitions/MeasurementBlock" }, "longDescription": "This property shall contain an array of DSP0274-defined measurement blocks.", "type": "array", "versionAdded": "v1_12_0", "versionDeprecated": "v1_14_0" }, "MediaType": { "anyOf": [ { "$ref": "#/definitions/MediaType" }, { "type": "null" } ], "description": "The type of media contained in this drive.", "longDescription": "This property shall contain the type of media contained in the associated drive.", "readonly": true }, "Metrics": { "anyOf": [ { "$ref": "http://redfish.dmtf.org/schemas/v1/DriveMetrics.json#/definitions/DriveMetrics" }, { "type": "null" } ], "description": "The link to the metrics associated with this drive.", "longDescription": "This property shall contain a link to the metrics associated with this drive.", "readonly": true, "versionAdded": "v1_17_0" }, "Model": { "description": "The model number for the drive.", "longDescription": "This property shall contain the name by which the manufacturer generally refers to the drive.", "readonly": true, "type": [ "string", "null" ] }, "Multipath": { "description": "An indication of whether the drive is accessible from multiple paths.", "longDescription": "This property shall indicate whether the drive is accessible by an initiator from multiple paths allowing for failover capabilities upon a path failure.", "readonly": true, "type": [ "boolean", "null" ], "versionAdded": "v1_9_0" }, "NVMe": { "anyOf": [ { "$ref": "#/definitions/NVMe" }, { "type": "null" } ], "description": "NVMe properties for this drive.", "longDescription": "This property shall contain NVMe-specific properties of this drive.", "versionAdded": "v1_20_0" }, "Name": { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Name", "readonly": true }, "NegotiatedSpeedGbs": { "description": "The speed, in gigabits per second (Gbit/s) units, at which this drive currently communicates to the storage controller.", "longDescription": "This property shall contain current bus speed, in gigabits per second (Gbit/s) units, of the associated drive.", "readonly": true, "type": [ "number", "null" ], "units": "Gbit/s" }, "Oem": { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem", "description": "The OEM extension property.", "longDescription": "This property shall contain the OEM extensions. All values for properties that this object contains shall conform to the Redfish Specification-described requirements." }, "Operations": { "description": "The operations currently running on the drive.", "items": { "$ref": "#/definitions/Operations" }, "longDescription": "This property shall contain a list of all operations currently running on the drive.", "type": "array", "versionAdded": "v1_1_0" }, "PartNumber": { "description": "The part number for this drive.", "longDescription": "This property shall contain the part number assigned by the organization that is responsible for producing or manufacturing the drive.", "readonly": true, "type": [ "string", "null" ] }, "PhysicalLocation": { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Location", "description": "The location of the drive. This property is equivalent to the `Location` property common to other standard Redfish resources.", "longDescription": "This property shall contain the location information of the associated drive.", "versionAdded": "v1_4_0" }, "PredictedMediaLifeLeftPercent": { "description": "The percentage of reads and writes that are predicted to be available for the media.", "longDescription": "This property shall contain an indicator of the percentage, typically `0` to `100`, of life remaining in the drive's media.", "minimum": 0, "readonly": true, "type": [ "number", "null" ], "units": "%" }, "Protocol": { "anyOf": [ { "$ref": "http://redfish.dmtf.org/schemas/v1/Protocol.json#/definitions/Protocol" }, { "type": "null" } ], "description": "The protocol that this drive currently uses to communicate to the storage controller.", "longDescription": "This property shall contain the protocol that the associated drive currently uses to communicate to the storage controller for this system.", "readonly": true }, "ReadyToRemove": { "description": "An indication of whether the drive is prepared by the system for removal.", "longDescription": "This property shall indicate whether the system is prepared for the removal of this drive.", "readonly": false, "type": [ "boolean", "null" ], "versionAdded": "v1_10_0" }, "Revision": { "description": "The revision of a SCSI-based drive, as returned from the 'Inquiry' command, which can be the firmware or hardware version. For other types of drives, the `HardwareVersion` and `FirmwareVersion` properties are recommended in favor of this property.", "longDescription": "This property shall contain the manufacturer-defined revision for a SCSI-based drive, as returned in the 'Product Revision Level' field from the 'Inquiry' command, which can be the firmware or hardware version. For other types of drives, this property should not be present and services should support the `HardwareVersion` and `FirmwareVersion` properties in favor of this property. If this property is present for drives that are not SCSI-based, the value may contain a firmware version, hardware version, or a combination.", "readonly": true, "type": [ "string", "null" ] }, "RotationSpeedRPM": { "description": "The rotation speed of this drive, in revolutions per minute (RPM) units.", "longDescription": "This property shall contain the rotation speed, in revolutions per minute (RPM) units, of the associated drive.", "readonly": true, "type": [ "number", "null" ], "units": "{rev}/min" }, "SKU": { "description": "The SKU for this drive.", "longDescription": "This property shall contain the stock-keeping unit (SKU) number for this drive.", "readonly": true, "type": [ "string", "null" ] }, "SecurityIDOwned": { "description": "Indicates if the TCG-defined security ID (SID) was changed from its default value, flagging the drive as owned.", "longDescription": "This property shall indicate if a TCG-defined security ID (SID) differs from the TCG-defined manufacturing security ID (MSID) on the drive, flagging the drive as owned. The value `true` shall indicate that the MSID and SID differ. This property should not be present for non-self-encrypting (SED) drives.", "readonly": true, "type": [ "boolean", "null" ], "versionAdded": "v1_22_0" }, "SerialNumber": { "description": "The serial number for this drive.", "longDescription": "This property shall contain the manufacturer-allocated number that identifies the drive.", "readonly": true, "type": [ "string", "null" ] }, "SlotCapableProtocols": { "description": "The drive protocols capable in this slot.", "items": { "anyOf": [ { "$ref": "http://redfish.dmtf.org/schemas/v1/Protocol.json#/definitions/Protocol" }, { "type": "null" } ] }, "longDescription": "This property shall contain the drive protocols capable in this slot. The value of this property depends upon the connector in this slot, the storage controllers connected to this slot, the configuration of the system, and other constraints that determine if a particular protocol is capable at a given time.", "readonly": true, "type": "array", "versionAdded": "v1_16_0" }, "SlotFormFactor": { "anyOf": [ { "$ref": "#/definitions/FormFactor" }, { "type": "null" } ], "description": "The form factor of the slot.", "longDescription": "This property shall contain the form factor of the slot.", "readonly": true, "versionAdded": "v1_16_0" }, "SparePartNumber": { "description": "The spare part number of the drive.", "longDescription": "This property shall contain the spare part number of the drive.", "readonly": true, "type": [ "string", "null" ], "versionAdded": "v1_19_0" }, "Status": { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Status", "description": "The status and health of the resource and its subordinate or dependent resources.", "longDescription": "This property shall contain any status or health properties of the resource." }, "StatusIndicator": { "anyOf": [ { "$ref": "#/definitions/StatusIndicator" }, { "type": "null" } ], "description": "The state of the status indicator, which communicates status information about this drive.", "longDescription": "This property shall contain the status indicator state for the status indicator associated with this drive. The `@Redfish.AllowableValues` annotation specifies the valid values for this property.", "readonly": false }, "TargetConfigurationLockLevel": { "anyOf": [ { "$ref": "#/definitions/TargetConfigurationLockLevel" }, { "type": "null" } ], "description": "Indicates the target configuration lock level for the drive based upon the state of the `ConfigurationLock` property. Other properties, such as `ConfigurationLockState`, contain additional information regarding the status of the configuration lock.", "longDescription": "This property shall contain the target configuration lock level for the drive. For NVMe drives, services shall implement the locking requirements specified by SNIA's Swordfish NVMe Model Overview and Mapping Guide.", "readonly": false, "versionAdded": "v1_20_0" }, "WriteCacheEnabled": { "description": "An indication of whether the drive write cache is enabled.", "longDescription": "This property shall indicate whether the drive write cache is enabled.", "readonly": false, "type": [ "boolean", "null" ], "versionAdded": "v1_7_0" } }, "required": [ "@odata.id", "@odata.type", "Id", "Name" ], "type": "object" }, "EncryptionAbility": { "enum": [ "None", "SelfEncryptingDrive", "Other" ], "enumDescriptions": { "None": "The drive is not capable of self-encryption.", "Other": "The drive is capable of self-encryption through some other means.", "SelfEncryptingDrive": "The drive is capable of self-encryption per the Trusted Computing Group's Self Encrypting Drive Standard." }, "type": "string" }, "EncryptionStatus": { "enum": [ "Unecrypted", "Unlocked", "Locked", "Foreign", "Unencrypted" ], "enumDeprecated": { "Unecrypted": "This value has been deprecated in favor of Unencrypted." }, "enumDescriptions": { "Foreign": "The drive is currently encrypted, the data is not accessible to the user, and the system requires user intervention to expose the data.", "Locked": "The drive is currently encrypted and the data is not accessible to the user. However, the system can unlock the drive automatically.", "Unecrypted": "The drive is not currently encrypted.", "Unencrypted": "The drive is not currently encrypted.", "Unlocked": "The drive is currently encrypted but the data is accessible to the user in unencrypted form." }, "enumVersionAdded": { "Unencrypted": "v1_1_0" }, "enumVersionDeprecated": { "Unecrypted": "v1_1_0" }, "type": "string" }, "FormFactor": { "enum": [ "Drive3_5", "Drive2_5", "EDSFF", "EDSFF_1U_Long", "EDSFF_1U_Short", "EDSFF_E3_Short", "EDSFF_E3_Long", "M2", "M2_2230", "M2_2242", "M2_2260", "M2_2280", "M2_22110", "U2", "PCIeSlotFullLength", "PCIeSlotLowProfile", "PCIeHalfLength", "OEM" ], "enumDescriptions": { "Drive2_5": "A 2.5 inch drive.", "Drive3_5": "A 3.5 inch drive.", "EDSFF": "An EDSFF drive.", "EDSFF_1U_Long": "An EDSFF 1U Long (E1.L) drive.", "EDSFF_1U_Short": "An EDSFF 1U Short (E1.S) drive.", "EDSFF_E3_Long": "An EDSFF E3 Long (E3.L) drive.", "EDSFF_E3_Short": "An EDSFF E3 Short (E3.S) drive.", "M2": "An M.2 drive.", "M2_22110": "An M.2 22110 drive.", "M2_2230": "An M.2 2230 drive.", "M2_2242": "An M.2 2242 drive.", "M2_2260": "An M.2 2260 drive.", "M2_2280": "An M.2 2280 drive.", "OEM": "An OEM-defined form factor.", "PCIeHalfLength": "A half-length PCIe add-in card.", "PCIeSlotFullLength": "A full-length PCIe add-in card.", "PCIeSlotLowProfile": "A low-profile PCIe add-in card.", "U2": "A U.2 drive." }, "enumLongDescriptions": { "Drive2_5": "This value shall indicate the drive is approximately 2.5 inches in width and no more than 0.8 inches in height and is not a U.2 drive.", "Drive3_5": "This value shall indicate the drive is approximately 3.5 inches in width and no more than 1.1 inches in height.", "EDSFF": "This value shall indicate the drive corresponds to one of SNIA's SFF specifications with an unspecified form factor. The `SlotFormFactor` property should not contain this value.", "EDSFF_1U_Long": "This value shall indicate the drive corresponds to the SFF-TA-1007 Specification.", "EDSFF_1U_Short": "This value shall indicate the drive corresponds to the SFF-TA-1006 Specification.", "EDSFF_E3_Long": "This value shall indicate the drive corresponds to the SFF-TA-1008 Specification and is approximately 142.2 mm in length.", "EDSFF_E3_Short": "This value shall indicate the drive corresponds to the SFF-TA-1008 Specification and is approximately 112.75 mm in length.", "M2": "This value shall indicate the drive corresponds to the PCI Express M.2 Specification with an unspecified form factor. The `SlotFormFactor` property should not contain this value.", "M2_22110": "This value shall indicate the drive corresponds to the PCI Express M.2 Specification and is approximately 22 mm in width and 110 mm in length.", "M2_2230": "This value shall indicate the drive corresponds to the PCI Express M.2 Specification and is approximately 22 mm in width and 30 mm in length.", "M2_2242": "This value shall indicate the drive corresponds to the PCI Express M.2 Specification and is approximately 22 mm in width and 42 mm in length.", "M2_2260": "This value shall indicate the drive corresponds to the PCI Express M.2 Specification and is approximately 22 mm in width and 60 mm in length.", "M2_2280": "This value shall indicate the drive corresponds to the PCI Express M.2 Specification and is approximately 22 mm in width and 80 mm in length.", "OEM": "This value shall indicate the drive is an OEM-defined form factor.", "PCIeHalfLength": "This value shall indicate the drive is an add-in card less than 7 inches in length.", "PCIeSlotFullLength": "This value shall indicate the drive is an add-in card greater than 7 inches in length.", "PCIeSlotLowProfile": "This value shall indicate the drive is an add-in card less than 2.5 inches in height.", "U2": "This value shall indicate the drive corresponds to the PCI Express SFF-8639 Module Specification." }, "enumVersionAdded": { "EDSFF": "v1_18_0", "M2": "v1_18_0" }, "type": "string" }, "FreezePersonality": { "additionalProperties": false, "description": "This action freezes a personality for the NVMe subsystem.", "longDescription": "This action shall freeze a personality for the NVMe subsystem as defined by the 'Configurable Device Personality' feature in the NVMe Base Specification.", "parameters": { "Personality": { "description": "The personality to freeze. `255` indicates all personalities.", "longDescription": "This parameter shall contain the personality to freeze as defined by the 'Personality Identifier List' figure in the NVMe Base Specification. The value `255` shall indicate all personalities.", "maximum": 255, "minimum": 0, "requiredParameter": true, "type": "integer" } }, "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "target": { "description": "Link to invoke action", "format": "uri-reference", "type": "string" }, "title": { "description": "Friendly action name", "type": "string" } }, "type": "object", "versionAdded": "v1_22_0" }, "GetPersonalityNonce": { "actionResponse": { "$ref": "#/definitions/GetPersonalityNonceResponse" }, "additionalProperties": false, "description": "This action obtains a nonce required to unfreeze personalities with a programmed key.", "longDescription": "This action shall obtain a nonce required to unfreeze personalities with a programmed key as defined by the 'CDP Random Nonce Data' clause in the NVMe Base Specification.", "parameters": {}, "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "target": { "description": "Link to invoke action", "format": "uri-reference", "type": "string" }, "title": { "description": "Friendly action name", "type": "string" } }, "type": "object", "versionAdded": "v1_22_0" }, "GetPersonalityNonceResponse": { "additionalProperties": false, "description": "The personality nonce from a drive.", "longDescription": "This object shall contain the personality nonce from a drive.", "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "Nonce": { "description": "The personality nonce.", "longDescription": "This property shall contain the personality nonce as a hex-encoded string as defined by the 'CDP Random Nonce Data' clause of the NVMe Base Specification.", "pattern": "^([0-9a-fA-F]{2})+$", "readonly": true, "type": "string", "versionAdded": "v1_22_0" } }, "required": [ "Nonce" ], "type": "object" }, "HotspareReplacementModeType": { "enum": [ "Revertible", "NonRevertible" ], "enumDescriptions": { "NonRevertible": "The hot spare drive that is commissioned due to a drive failure remains as a data drive and does not revert to a hot spare if the failed drive is replaced.", "Revertible": "The hot spare drive that is commissioned due to a drive failure reverts to a hot spare after the failed drive is replaced and rebuilt." }, "type": "string" }, "HotspareType": { "enum": [ "None", "Global", "Chassis", "Dedicated" ], "enumDescriptions": { "Chassis": "The drive is serving as a hot spare for all other drives in this storage domain that are contained in the same chassis.", "Dedicated": "The drive is serving as a hot spare for a user-defined set of drives or volumes. Clients cannot specify this value when modifying the `HotspareType` property. This value is reported as a result of configuring the spare drives within a volume.", "Global": "The drive is serving as a hot spare for all other drives in this storage domain.", "None": "The drive is not a hot spare." }, "type": "string" }, "Links": { "additionalProperties": false, "description": "The links to other resources that are related to this resource.", "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.", "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "ActiveSoftwareImage": { "$ref": "http://redfish.dmtf.org/schemas/v1/SoftwareInventory.json#/definitions/SoftwareInventory", "description": "The link to the software inventory that represents the active drive firmware image.", "longDescription": "This property shall contain a link a resource of type `SoftwareInventory` that represents the active drive firmware image.", "readonly": false, "versionAdded": "v1_16_0" }, "Chassis": { "$ref": "http://redfish.dmtf.org/schemas/v1/Chassis.json#/definitions/Chassis", "description": "The link to the chassis that contains this drive.", "longDescription": "This property shall contain a link to a resource of type `Chassis` that represents the physical container associated with this drive.", "readonly": true, "versionAdded": "v1_2_0" }, "Endpoints": { "description": "An array of links to the endpoints that connect to this drive.", "items": { "$ref": "http://redfish.dmtf.org/schemas/v1/Endpoint.json#/definitions/Endpoint" }, "longDescription": "This property shall contain an array of links to resources of type `Endpoint` with which this drive is associated.", "readonly": true, "type": "array", "versionAdded": "v1_1_0" }, "Endpoints@odata.count": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count" }, "NetworkDeviceFunctions": { "description": "An array of links to the network device functions that provide network connectivity for this drive.", "items": { "$ref": "http://redfish.dmtf.org/schemas/v1/NetworkDeviceFunction.json#/definitions/NetworkDeviceFunction" }, "longDescription": "This property shall contain the array of links to resources of type `NetworkDeviceFunction`. This property should only be present for drives with network connectivity, such as Ethernet attached drives.", "readonly": true, "type": "array", "versionAdded": "v1_14_0" }, "NetworkDeviceFunctions@odata.count": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count" }, "Oem": { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem", "description": "The OEM extension property.", "longDescription": "This property shall contain the OEM extensions. All values for properties contained in this object shall conform to the Redfish Specification-described requirements." }, "PCIeFunctions": { "description": "An array of links to the PCIe functions that the drive produces.", "items": { "$ref": "http://redfish.dmtf.org/schemas/v1/PCIeFunction.json#/definitions/PCIeFunction" }, "longDescription": "This property shall link to a resource of type `PCIeFunction` that represents the PCIe functions associated with this resource.", "type": "array", "versionAdded": "v1_6_0" }, "PCIeFunctions@odata.count": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count" }, "SoftwareImages": { "description": "The images that are associated with this drive.", "items": { "$ref": "http://redfish.dmtf.org/schemas/v1/SoftwareInventory.json#/definitions/SoftwareInventory" }, "longDescription": "This property shall contain an array of links to resources of type `SoftwareInventory` that represent the firmware images that apply to this drive.", "readonly": true, "type": "array", "versionAdded": "v1_16_0" }, "SoftwareImages@odata.count": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count" }, "Storage": { "$ref": "http://redfish.dmtf.org/schemas/v1/Storage.json#/definitions/Storage", "description": "A link to the storage subsystem to which this drive belongs.", "longDescription": "This property shall contain a link to a resource of type `Storage` that represents the storage subsystem to which this drive belongs.", "readonly": true, "versionAdded": "v1_13_0" }, "StoragePools": { "description": "An array of links to the storage pools to which this drive belongs.", "items": { "$ref": "http://redfish.dmtf.org/schemas/swordfish/v1/StoragePool.json#/definitions/StoragePool" }, "longDescription": "This property shall contain an array of links of type `StoragePool` to which this drive belongs.", "readonly": true, "type": "array", "versionAdded": "v1_8_0" }, "StoragePools@odata.count": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count" }, "Volumes": { "description": "An array of links to the volumes that this drive either wholly or only partially contains.", "items": { "$ref": "http://redfish.dmtf.org/schemas/swordfish/v1/Volume.json#/definitions/Volume" }, "longDescription": "This property shall contain an array of links to resources of type `Volume` with which this drive is associated. This property shall include all volume resources of which this drive is a member and all volumes for which this drive acts as a spare if the hot spare type is `Dedicated`.", "readonly": true, "type": "array" }, "Volumes@odata.count": { "$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/count" } }, "type": "object" }, "MediaType": { "enum": [ "HDD", "SSD", "SMR" ], "enumDescriptions": { "HDD": "The drive media type is traditional magnetic platters.", "SMR": "The drive media type is shingled magnetic recording.", "SSD": "The drive media type is solid state or flash memory." }, "type": "string" }, "NMVeMinimumRequiredResetType": { "enum": [ "NoReset", "ControllerLevel", "LimitedControllerLevel", "NVMSubsystemReset", "PowerCycle" ], "enumDescriptions": { "ControllerLevel": "A Controller Level Reset is required.", "LimitedControllerLevel": "A Controller Level Reset other than a Controller Level Reset initiated by a Controller Reset is required.", "NVMSubsystemReset": "An NVM Subsystem Reset is required.", "NoReset": "No reset required.", "PowerCycle": "A power cycle is required." }, "type": "string" }, "NMVePersonalityKeyAlgorithm": { "enum": [ "HMAC_SHA384" ], "enumDescriptions": { "HMAC_SHA384": "HMAC-SHA-384." }, "type": "string" }, "NMVeUnfreezeAuthMode": { "enum": [ "ProgrammedKey", "PhysicalId" ], "enumDescriptions": { "PhysicalId": "Physical Credential Authentication.", "ProgrammedKey": "Programmable Key Authentication." }, "type": "string" }, "NVMe": { "additionalProperties": false, "description": "NVMe properties for a drive.", "longDescription": "This type shall contain NVMe-specific properties of a drive.", "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "ActivePersonalities": { "description": "The active personality settings of the NVMe subsystem.", "items": { "anyOf": [ { "$ref": "#/definitions/NVMePersonality" }, { "type": "null" } ] }, "longDescription": "This property shall contain the active personality settings of the NVMe subsystem as defined by the NVMe Device Personalities log page and NVMe Configurable Device Personality feature.", "type": "array", "versionAdded": "v1_22_0" }, "ConfigurationLockState": { "anyOf": [ { "$ref": "#/definitions/NVMeConfigurationLockState" }, { "type": "null" } ], "description": "The configurable features that are able to be locked from in-band usage on an NVMe subsystem and their current lock state.", "longDescription": "This property shall contain the configurable features that are able to be locked from in-band usage on an NVMe subsystem and their current lock state.", "versionAdded": "v1_20_0" } }, "type": "object" }, "NVMeConfigurationLockState": { "additionalProperties": false, "description": "The configurable features that are able to be locked on an NVMe subsystem and their current lock state.", "longDescription": "This type shall contain the configurable features that are able to be locked on an NVMe subsystem and their current lock state.", "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "FirmwareCommit": { "anyOf": [ { "$ref": "#/definitions/ConfigLockOptions" }, { "type": "null" } ], "description": "The lock state of the NVMe-defined Firmware Commit command.", "longDescription": "This property shall contain the lock state of the NVMe-defined Firmware Commit command.", "readonly": true, "versionAdded": "v1_20_0" }, "FirmwareImageDownload": { "anyOf": [ { "$ref": "#/definitions/ConfigLockOptions" }, { "type": "null" } ], "description": "The lock state of the NVMe-defined Firmware Image Download command.", "longDescription": "This property shall contain the lock state of the NVMe-defined Firmware Image Download command.", "readonly": true, "versionAdded": "v1_20_0" }, "Lockdown": { "anyOf": [ { "$ref": "#/definitions/ConfigLockOptions" }, { "type": "null" } ], "description": "The lock state of the NVMe-defined Lockdown command.", "longDescription": "This property shall contain the lock state of the NVMe-defined Lockdown command.", "readonly": true, "versionAdded": "v1_20_0" }, "SecuritySend": { "anyOf": [ { "$ref": "#/definitions/ConfigLockOptions" }, { "type": "null" } ], "description": "The lock state of the NVMe-defined Security Send command.", "longDescription": "This property shall contain the lock state of the NVMe-defined Security Send command.", "readonly": true, "versionAdded": "v1_20_0" }, "VPDWrite": { "anyOf": [ { "$ref": "#/definitions/ConfigLockOptions" }, { "type": "null" } ], "description": "The lock state of the NVMe-MI-defined VPD Write command.", "longDescription": "This property shall contain the lock state of the NVMe-MI-defined VPD Write command.", "readonly": true, "versionAdded": "v1_20_0" } }, "type": "object" }, "NVMePersonality": { "additionalProperties": false, "description": "An active personality setting of an NVMe subsystem.", "longDescription": "This type shall contain an active personality setting of an NVMe subsystem as defined by the NVMe Device Personalities log page and NVMe Configurable Device Personality feature.", "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "ChangeAffectsUserData": { "description": "An indication of whether changing this personality affects user data.", "longDescription": "This property shall indicate whether changing this personality affects user data as defined by the 'Personality Settings Change User Data Effect' field in the NVMe Base Specification.", "readonly": true, "type": [ "boolean", "null" ], "versionAdded": "v1_22_0" }, "Data": { "description": "The personality data.", "longDescription": "This property shall contain the personality data as a hex-encoded string.", "pattern": "^([0-9a-fA-F]{2})+$", "readonly": false, "type": [ "string", "null" ], "versionAdded": "v1_22_0" }, "Default": { "description": "An indication of whether this personality is set to the manufacturing default values.", "longDescription": "This property shall indicate whether this personality is set to the manufacturing default values as defined by the 'Personality Manufacturing Default Settings State' field in the NVMe Base Specification.", "readonly": true, "type": [ "boolean", "null" ], "versionAdded": "v1_22_0" }, "Frozen": { "description": "An indication of whether this personality is frozen.", "longDescription": "This property shall indicate whether this personality is frozen as defined by the 'Personality Freeze State' field in the NVMe Base Specification.", "readonly": true, "type": [ "boolean", "null" ], "versionAdded": "v1_22_0" }, "Identifier": { "description": "The personality identifier.", "longDescription": "This property shall contain the personality identifier as defined by the 'Personality Identifier List' figure in the NVMe Base Specification.", "maximum": 254, "minimum": 0, "readonly": true, "type": [ "integer", "null" ], "versionAdded": "v1_22_0" }, "MinimumRequiredResetType": { "anyOf": [ { "$ref": "#/definitions/NMVeMinimumRequiredResetType" }, { "type": "null" } ], "description": "The minimum reset type required to change the personality settings.", "longDescription": "This property shall contain the minimum reset type required to change the personality settings as defined by the 'Minimum Required Reset Type' field in the NVMe Base Specification.", "readonly": true, "versionAdded": "v1_22_0" }, "Pending": { "description": "An indication of whether this personality contains pending changes.", "longDescription": "This property shall indicate whether this personality contains pending changes as defined by the 'Pending Personality Settings Change' field in the NVMe Base Specification.", "readonly": true, "type": [ "boolean", "null" ], "versionAdded": "v1_22_0" }, "UnfreezeAuthenticationModes": { "description": "The authentication modes supported to unfreeze this personality.", "items": { "anyOf": [ { "$ref": "#/definitions/NMVeUnfreezeAuthMode" }, { "type": "null" } ] }, "longDescription": "This property shall contain the authentication modes supported to unfreeze this personality as defined by the 'Authenticated Unfreeze Support' field in the NVMe Base Specification.", "readonly": true, "type": "array", "versionAdded": "v1_22_0" } }, "type": "object" }, "OemActions": { "additionalProperties": true, "description": "The available OEM-specific actions for this resource.", "longDescription": "This type shall contain the available OEM-specific actions for this resource.", "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": {}, "type": "object" }, "Operations": { "additionalProperties": false, "description": "An operation currently running on this resource.", "longDescription": "This type shall describe a currently running operation on the resource.", "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "AssociatedTask": { "$ref": "http://redfish.dmtf.org/schemas/v1/Task.json#/definitions/Task", "description": "The link to the task associated with the operation, if any.", "longDescription": "This property shall contain a link to a resource of type `Task` that represents the task associated with the operation.", "readonly": true, "versionAdded": "v1_1_0" }, "Operation": { "anyOf": [ { "$ref": "http://redfish.dmtf.org/schemas/swordfish/v1/Volume.json#/definitions/OperationType" }, { "type": "null" } ], "description": "The type of the operation.", "longDescription": "This property shall contain the type of the operation.", "readonly": true, "versionAdded": "v1_17_0" }, "OperationName": { "deprecated": "This property is deprecated in favor of the `Operation` property using the `OperationType` enumeration defined in the `Volume` schema.", "description": "The name of the operation.", "longDescription": "This property shall contain a string of the name of the operation.", "readonly": true, "type": [ "string", "null" ], "versionAdded": "v1_1_0", "versionDeprecated": "v1_17_0" }, "PercentageComplete": { "description": "The percentage of the operation that has been completed.", "longDescription": "This property shall contain an integer of the percentage, `0` to `100`, of the operation that has been completed.", "maximum": 100, "minimum": 0, "readonly": true, "type": [ "integer", "null" ], "units": "%", "versionAdded": "v1_1_0" } }, "type": "object" }, "Reset": { "additionalProperties": false, "description": "This action resets this drive.", "longDescription": "This action shall reset this drive.", "parameters": { "ResetType": { "$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/ResetType", "description": "The type of reset.", "longDescription": "This parameter shall contain the type of reset. The service can accept a request without the parameter and perform an implementation-specific default reset." } }, "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "target": { "description": "Link to invoke action", "format": "uri-reference", "type": "string" }, "title": { "description": "Friendly action name", "type": "string" } }, "type": "object", "versionAdded": "v1_7_0" }, "RevertPersonalitiesToDefaults": { "additionalProperties": false, "description": "This action reverts all personalities to their manufacturing default state for the NVMe subsystem.", "longDescription": "This action shall revert all personalities to their manufacturing default state for the NVMe subsystem as defined by the 'Manufacturing Default Personality' clause of the NVMe Base Specification.", "parameters": {}, "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "target": { "description": "Link to invoke action", "format": "uri-reference", "type": "string" }, "title": { "description": "Friendly action name", "type": "string" } }, "type": "object", "versionAdded": "v1_22_0" }, "RevertToOriginalFactoryState": { "additionalProperties": false, "description": "This action reverts a self-encrypting drive (SED) to the original factory state.", "longDescription": "This action shall revert a self-encrypting drive (SED) to the original factory state. Upon successful completion of this action, the drive data shall be securely erased and the `EncryptionStatus` property shall contain `Unencrypted`.", "parameters": { "PhysicalSecureID": { "description": "The physical secure ID (PSID). The PSID is generally printed on the drive label and used to revert an encrypted SED.", "longDescription": "This parameter shall contain the physical secure ID (PSID). The PSID is generally printed on the drive label and used to revert an encrypted SED.", "type": "string" } }, "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "target": { "description": "Link to invoke action", "format": "uri-reference", "type": "string" }, "title": { "description": "Friendly action name", "type": "string" } }, "type": "object", "versionAdded": "v1_18_0" }, "SecureErase": { "additionalProperties": false, "description": "This action securely erases the contents of the drive.", "longDescription": "This action shall securely erase the drive.", "parameters": { "OverwritePasses": { "description": "The number of times to overwrite the drive if performing an overwrite type of sanitization.", "longDescription": "This parameter shall contain the number of times to overwrite the drive if the `SanitizationType` parameter contains the value `Overwrite`. This parameter shall be ignored if the `SanitizationType` parameter does not contain the value `Overwrite`. If the client does not provide this parameter, the service shall perform an implementation-specific number of passes.", "type": "integer", "versionAdded": "v1_15_0" }, "SanitizationType": { "$ref": "#/definitions/DataSanitizationType", "description": "The type of data sanitization to perform.", "longDescription": "This parameter shall contain the type of data sanitization to perform for the secure erase request. The service can accept a request without the parameter and perform an implementation-specific default secure erase.", "versionAdded": "v1_15_0" } }, "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "target": { "description": "Link to invoke action", "format": "uri-reference", "type": "string" }, "title": { "description": "Friendly action name", "type": "string" } }, "type": "object" }, "SetPersonalityKey": { "additionalProperties": false, "description": "This action sets the personality key for the NVMe subsystem.", "longDescription": "This action shall set the personality key for the NVMe subsystem as defined by the 'Programmable Key Authentication Considerations' clause in the NVMe Base Specification.", "parameters": { "Algorithm": { "$ref": "#/definitions/NMVePersonalityKeyAlgorithm", "description": "The type of authentication algorithm for the key.", "longDescription": "This parameter shall contain the type of authentication algorithm for the key as defined by the 'CDP Authentication Algorithm' field in the NVMe Base Specification.", "requiredParameter": true }, "Key": { "description": "The personality key to set on the NVMe subsystem.", "longDescription": "This parameter shall contain the personality key to set on the NVMe subsystem as a hex-encoded string.", "pattern": "^([0-9a-fA-F]{2})+$", "requiredParameter": true, "type": "string" } }, "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "target": { "description": "Link to invoke action", "format": "uri-reference", "type": "string" }, "title": { "description": "Friendly action name", "type": "string" } }, "type": "object", "versionAdded": "v1_22_0" }, "StatusIndicator": { "enum": [ "OK", "Fail", "Rebuild", "PredictiveFailureAnalysis", "Hotspare", "InACriticalArray", "InAFailedArray" ], "enumDescriptions": { "Fail": "The drive has failed.", "Hotspare": "The drive has been marked to automatically rebuild and replace a failed drive.", "InACriticalArray": "The array to which this drive belongs has been degraded.", "InAFailedArray": "The array to which this drive belongs has failed.", "OK": "The drive is OK.", "PredictiveFailureAnalysis": "The drive still works but is predicted to fail soon.", "Rebuild": "The drive is being rebuilt." }, "type": "string" }, "TargetConfigurationLockLevel": { "enum": [ "Baseline" ], "enumDescriptions": { "Baseline": "The standard configuration lock level, corresponding to applying firmware, updating security keys, and modifying other hardware settings. It does not include managing the volumes or data on the drive." }, "type": "string" }, "UnfreezePersonality": { "additionalProperties": false, "description": "This action unfreezes a personality for the NVMe subsystem.", "longDescription": "This action shall unfreeze a personality for the NVMe subsystem as defined by the 'Authenticated Unfreeze Operation' clause in the NVMe Base Specification.", "parameters": { "AuthenticationMethod": { "$ref": "#/definitions/NMVeUnfreezeAuthMode", "description": "The authentication method for the unfreeze operation.", "longDescription": "This parameter shall contain the authentication method for the unfreeze operation as defined by the 'Authenticated Unfreeze Support' field in the NVMe Base Specification.", "requiredParameter": true }, "Key": { "description": "The authentication key for the unfreeze operation.", "longDescription": "This parameter shall contain the authentication key for the unfreeze operation as a hex-encoded string. If `AuthenticationMethod` contains `ProgrammedKey`, this parameter contains a key that is derived from the original key provided in the `SetPersonalityKey` action. If `AuthenticationMethod` contains `PhysicalId`, this parameter contains the physical secure ID (PSID) of the drive converted to a hex-encoded string.", "pattern": "^([0-9a-fA-F]{2})+$", "requiredParameter": true, "type": "string" }, "Nonce": { "description": "The personality nonce provided by the `GetPersonalityNonce` action.", "longDescription": "This parameter shall contain the personality nonce provided by the `GetPersonalityNonce` action. This parameter shall be required if `AuthenticationMethod` contains `ProgrammedKey`.", "pattern": "^([0-9a-fA-F]{2})+$", "type": "string" }, "Personality": { "description": "The personality to freeze. `255` indicates all personalities.", "longDescription": "This parameter shall contain the personality to freeze as defined by the 'Personality Identifier List' figure in the NVMe Base Specification. The value `255` shall indicate all personalities.", "maximum": 255, "minimum": 0, "requiredParameter": true, "type": "integer" } }, "patternProperties": { "^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": { "description": "This property shall specify a valid odata or Redfish property.", "type": [ "array", "boolean", "integer", "number", "null", "object", "string" ] } }, "properties": { "target": { "description": "Link to invoke action", "format": "uri-reference", "type": "string" }, "title": { "description": "Friendly action name", "type": "string" } }, "type": "object", "versionAdded": "v1_22_0" } }, "language": "en", "owningEntity": "DMTF", "release": "2025.4", "title": "#Drive.v1_22_0.Drive" }