ConfigurableBootToNetworkISO Action

POST

/redfish/v1/Systems/{ComputerSystemId}/Oem/Dell/DellOSDeploymentService/Actions/DellOSDeploymentService.ConfigurableBootToNetworkISO

The ConfigurableBootToNetworkISO() method exposes an ISO Image present on a network share as a CDROM device to the host server for a specified exposure duration interval or by default for 18 hrs. Upon the successful execution, based on the ResetType parameter, the host system shall either immediately cold boot or warm boot. Upon this reset, the system shall then boot to the ISO Image. If ResetType specifies no immediate reboot, then upon the next host system reset, the system shall boot to the ISO Image. Furthermore, if immediate reset is not specified, then the system should be rebooted before the exposure duration interval expires, otherwise the system shall fail to boot to the ISO Image.

Privilege: ConfigureComponents, Login

NOTE: The ExposeDuration property in the POST payload should follow the CIM datetime string format (ddddddddHHmmSS.mmmmmm:000). For example: 0000-00-00T05:00:00-00:00

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

Body Params application/jsonRequired

Examples

Responses

🟢200成功

application/json

The response contains the results of the ConfigurableBootToNetworkISO action

Bodyapplication/json

🟢201成功

🟢202成功

🟢204删除成功

🔴500服务器错误

Request Example

Shell

JavaScript

Java

Swift

curl --location '/redfish/v1/Systems//Oem/Dell/DellOSDeploymentService/Actions/DellOSDeploymentService.ConfigurableBootToNetworkISO' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ExposeDuration": "2022-12-03T10:15:30+01:00",
    "HashType": "SHA1",
    "HashValue": "hash_string",
    "IPAddress": "1.2.3.4",
    "ImageName": "ImageName_String",
    "Password": "abc@1234",
    "ResetType": "ColdReset",
    "ShareName": "Sharename_string",
    "ShareType": "NFS",
    "UserName": "user_name",
    "Workgroup": "workgroup_string"
}'

Response Example

200 - Example 1

{
    "error": {
        "@Message.ExtendedInfo": [
            {}
        ],
        "code": "string",
        "message": "string"
    }
}

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

BootToNetworkISO Action

ConnectNetworkISOImage Action