Volume instance

GET

/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Volumes/{VolumeId}

Volume contains properties used to describe a volume, virtual disk, LUN, or other logical storage entity for any system.

Privilege: Login

Request

Authorization

Basic Auth

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

API Key

Add parameter in header

X-Auth-Token

Example:

X-Auth-Token: ********************

Path Params

Responses

🟢200成功

application/json

The response contains a representation of the Volume resource

Bodyapplication/json

🔴500服务器错误

Request Example

Shell

JavaScript

Java

Swift

curl --location '/redfish/v1/Systems//Storage//Volumes/' \
--header 'Authorization: Basic <encoded-value>'

Response Example

200 - 成功示例

{
    "@Redfish.Settings": {
        "@odata.context": "/redfish/v1/$metadata#Settings.Settings",
        "@odata.type": "#Settings.v1_4_0.Settings",
        "SettingsObject": {
            "@odata.id": "/redfish/v1/Systems/System.Embedded.1/Storage/RAID.SL.4-1/Volumes/Disk.Virtual.239:RAID.SL.4-1/Settings"
        },
        "SupportedApplyTimes": [
            "Immediate",
            "OnReset",
            "AtMaintenanceWindowStart",
            "InMaintenanceWindowOnReset"
        ]
    },
    "@odata.context": "/redfish/v1/$metadata#Volume.Volume",
    "@odata.id": "/redfish/v1/Systems/System.Embedded.1/Storage/RAID.SL.4-1/Volumes/Disk.Virtual.239:RAID.SL.4-1",
    "@odata.type": "#Volume.v1_10_0.Volume",
    "Actions": {
        "#Volume.CheckConsistency": {
            "@Redfish.OperationApplyTime@Redfish.AllowableValues": [
                "Immediate",
                "OnReset"
            ],
            "@Redfish.OperationApplyTimeSupport": {
                "@odata.type": "#Settings.v1_4_0.OperationApplyTimeSupport",
                "SupportedValues": [
                    "Immediate",
                    "OnReset"
                ]
            },
            "InitializeType@Redfish.AllowableValues": [
                "Fast",
                "Slow"
            ],
            "target": "/redfish/v1/Systems/System.Embedded.1/Storage/RAID.SL.4-1/Volumes/Disk.Virtual.239:RAID.SL.4-1/Actions/Volume.CheckConsistency"
        },
        "#Volume.Initialize": {
            "@Redfish.OperationApplyTime@Redfish.AllowableValues": [
                "Immediate",
                "OnReset"
            ],
            "@Redfish.OperationApplyTimeSupport": {
                "@odata.type": "#Settings.v1_4_0.OperationApplyTimeSupport",
                "SupportedValues": [
                    "Immediate",
                    "OnReset"
                ]
            },
            "InitializeType@Redfish.AllowableValues": [
                "Fast",
                "Slow"
            ],
            "target": "/redfish/v1/Systems/System.Embedded.1/Storage/RAID.SL.4-1/Volumes/Disk.Virtual.239:RAID.SL.4-1/Actions/Volume.Initialize"
        }
    },
    "BlockSizeBytes": 512,
    "CapacityBytes": 599550590976,
    "Description": "Virtual Disk 239 on RAID Controller in SL 4",
    "DisplayName": "Virtual Disk239",
    "Encrypted": false,
    "EncryptionTypes": [
        "NativeDriveEncryption"
    ],
    "EncryptionTypes@odata.count": 1,
    "Id": "Disk.Virtual.239:RAID.SL.4-1",
    "Identifiers": [],
    "Identifiers@odata.count": 0,
    "Links": {
        "Drives": [
            {
                "@odata.id": "/redfish/v1/Systems/System.Embedded.1/Storage/RAID.SL.4-1/Drives/Disk.Bay.0:Enclosure.Internal.0-1:RAID.SL.4-1"
            }
        ],
        "Drives@odata.count": 1
    },
    "MediaSpanCount": 1,
    "Name": "Virtual Disk239",
    "Oem": {
        "Dell": {
            "@odata.type": "#DellVolume.v1_0_0.DellVolume",
            "DellVirtualDisk": {
                "@odata.context": "/redfish/v1/$metadata#DellVirtualDisk.DellVirtualDisk",
                "@odata.id": "/redfish/v1/Systems/System.Embedded.1/Storage/RAID.SL.4-1/Volumes/Disk.Virtual.239:RAID.SL.4-1/Oem/Dell/DellVolumes/Disk.Virtual.239:RAID.SL.4-1",
                "@odata.type": "#DellVirtualDisk.v1_2_0.DellVirtualDisk",
                "BusProtocol": "SAS",
                "Cachecade": "NonCachecadeVD",
                "Description": "An instance of DellVirtualDisk will have data specific to the Virtual Disks in the system.",
                "DiskCachePolicy": "Disabled",
                "Id": "Disk.Virtual.239:RAID.SL.4-1",
                "LastSystemInventoryTime": "2025-10-29T04:21:26+00:00",
                "LastUpdateTime": "2025-10-29T04:20:51+00:00",
                "LockStatus": "Unlocked",
                "MediaType": "HardDiskDrive",
                "Name": "DellVirtualDisk",
                "ObjectStatus": "Current",
                "OperationName": "None",
                "OperationPercentComplete": 0,
                "PrimaryStatus": "OK",
                "RaidStatus": "Online",
                "ReadCachePolicy": "ReadAhead",
                "RemainingRedundancy": 0,
                "SpanDepth": 1,
                "SpanLength": 1,
                "StartingLBAinBlocks": 0,
                "StripeSize": "256KB",
                "T10PIStatus": "Disabled",
                "VirtualDiskTargetID": 239,
                "WriteCachePolicy": "WriteBack"
            },
            "DellVirtualDisk@Redfish.Deprecated": "Please migrate to use DellVolume",
            "DellVolume": {
                "BusProtocol": "SAS",
                "Cachecade": "NonCachecadeVD",
                "DiskCachePolicy": "Disabled",
                "DiskCachePolicy@Redfish.AllowableValues": [
                    "Default",
                    "Disabled",
                    "Enabled"
                ],
                "LastSystemInventoryTime": "2025-10-29T04:21:26+00:00",
                "LastUpdateTime": "2025-10-29T04:20:51+00:00",
                "LockStatus": "Unlocked",
                "MediaType": "HardDiskDrive",
                "ObjectStatus": "Current",
                "OperationName": "None",
                "OperationPercentComplete": 0,
                "PrimaryStatus": "OK",
                "RaidStatus": "Online",
                "RemainingRedundancy": 0,
                "SpanDepth": 1,
                "SpanLength": 1,
                "StartingLBAinBlocks": 0,
                "StripeSize": "256KB",
                "T10PIStatus": "Disabled",
                "VirtualDiskTargetID": 239
            }
        }
    },
    "Operations": [],
    "Operations@odata.count": 0,
    "OptimumIOSizeBytes": 262144,
    "RAIDType": "RAID0",
    "ReadCachePolicy": "ReadAhead",
    "ReadCachePolicy@Redfish.AllowableValues": [
        "ReadAhead",
        "AdaptiveReadAhead",
        "Off"
    ],
    "Status": {
        "Health": "OK",
        "HealthRollup": "OK",
        "State": "Enabled"
    },
    "VolumeType": "NonRedundant",
    "WriteCachePolicy": "ProtectedWriteBack",
    "WriteCachePolicy@Redfish.AllowableValues": [
        "WriteThrough",
        "ProtectedWriteBack",
        "UnprotectedWriteBack"
    ]
}

Modified at 2026-03-04 06:03:53

Volume instance

CheckConsistency Action