Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.
Sign In Create an Account Premier Sign In Partner Program Sign In
Contact Us

Your Dell.com Baskets

iDRAC9 Redfish API Guide Firmware version: 4.20.20.20

PDF

Supported Action — ConfigurableBootToNetworkISO

Description

The ConfigurableBootToNetworkISO action 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.

URL

/redfish/v1/Dell/Systems/<ComputerSystem-Id>/DellOSDeploymentService/Actions/DellOSDeploymentService.ConfigurableBootToNetworkISO

Supported HTTP Method and Privileges

HTTP Method Required Privilege
POST Login

Supported Parameters—ConfigurableBootToNetworkISO

NOTE A star (*) indicates a required parameter, else the parameter is optional.
Parameter Type Value Description
ExposeDuration DateTimeOffset Identifies the amount of time (up to 18 hours) for the ISO image file to be exposed as a local CD-ROM device to the host server after which it will be automatically detached. The default value shall be 18 hours, if the parameter is not specified. The format for intervals is: YYYY-MM-DDThh:mm:ss[.SSS](Z|(+|-)hh:mm)
HashType ENUM MD5, SHA1 Type of hash algorithm used to compute checksum.
HashValue String Checksum value in string format computed by using the 'HashType' algorithm.
IPAddress String NFS, CIFS, HTTP, HTTPS share IPv4 address. For example, 192.168.10.100.
ImageName String Name of the image file.
Password String Password, if applicable.
ResetType ENUM NoReset, WarmReset, ColdReset Specifies if the host system needs to be immediately forced to cold- or warm reset in order to boot to the ISO Image.
ShareName String Name of the CIFS share or full path to the NFS share. Optional for HTTP or HTTPS share, which may be treated as the path of the directory containing the file.
ShareType ENUM NFS, CIFS, TFTP Type of the network share.
UserName String User name, if applicable.
Workgroup String Optional. Workgroup for the CIFS share.

Supported Status Codes

HTTP Status Code Extended Information Error Message Code
400 OSD1, OSD16, OSD17, OSD19, OSD21, OSD28, OSD3, OSD30, OSD35, OSD36, OSD47, OSD50, OSD51, OSD64, OSD65, OSD9

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\