Skip to main content

POST – Create a Volume

Use the POST method to initialize volume.

Request URL​

POST https://<BMC_IPADDR>/redfish/v1/Systems/1/Storage/{Id}/Volumes

Request body​

Field

Type

Description

Name

Note 1		String

The new name with at most 15 characters.

RAIDType

Note 1		String

RAID TYPEs that the RAID controller and current env support.

CapacityBytes

Note 2		String

At least 1048576.

ReadCachePolicy

String

"Off" or "ReadAhead"

WriteCachePolicy

String

“WriteThrough”, "UnprotectedWriteBack" or "ProtectedWriteBack"

Oem/Lenovo/IOPolicy

String

“DirectIO” or “CachedIO”

Oem/Lenovo/AccessPolicy

String

“ReadWrite”, “ReadOnly” or “Blocked”

Oem/Lenovo/DriveCachePolicy

String

“Unchanged”, “Disable” or “Enable”

Note 1: This property is mandatory and should not be an empty string when creating a volume.

Note 2: It will be converted to a unit of megabyte at backend, so the property in GET operation may be different with the input value in POST operation. The minimum of the value is 1048576 (1MB = 1024 * 1024).

Response​

The response returns the created volumes information.

Status code​

HTTP Status CodeError Message ID
201Created
500InternalError

Example​

The following example is POST body

{
   "Name": "VD_4",
    "RAIDType": "RAID0"
}

The following example JSON response is returned.

{
    "@odata.id": "/redfish/v1/Systems/1/Storage/RAID_Slot2/Volumes/23",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "ReadCachePolicy@Redfish.AllowableValues": [
        "Off",
        "ReadAhead"
    ],
    "WriteCachePolicy@Redfish.AllowableValues": [
        "WriteThrough",
        "UnprotectedWriteBack",
        "ProtectedWriteBack"
    ],
    "Oem": {
        "Lenovo": {}
    },
    "@odata.type": "#Volume.v1_4_1.Volume",
    "Links": {
        "Drives": []
    },
    "Description": "This resource is used to represent a volume for a Redfish implementation.",
    "@odata.etag": "\"4eebd9cca6bc25aae12\"",
    "Actions": {
        "#Volume.Initialize": {
            "target": "/redfish/v1/Systems/1/Storage/RAID_Slot2/Volumes/23/Actions/Volume.Initialize",
            "title": "Initialize",
            "InitializeType@Redfish.AllowableValues": [
                "Fast"
            ]
        }
    },
    "AccessCapabilities": []
}