Configure BIOS Validation on Newly Discovered Devices
Use this API to configure BIOS validation on all newly discovered devices.
URI
https://[host]/api/juniper/servicenow/device-management/devices/ configureBIOSValidationOnNewlyDiscoveredDevices (HTTP method = POST)
Consumes
- application/vnd.juniper.servicenow.device-management.configurebiosvalidation+xml;version=1; charset=UTF-8
- application/vnd.juniper.servicenow.device-management.configurebiosvalidation+json;version=1; charset=UTF-8
Request Elements
Element | Type | Description |
|---|---|---|
doNotValidateBIOS | Boolean | Specifies whether or not BIOS validation should be enabled or disabled on all newly discovered devices |
Produces
- application/vnd.juniper.servicenow.device-management.servicenowmsg+xml;version=1
- application/vnd.juniper.servicenow.device-management.servicenowmsg+json;version=1
Response Elements
Element | Type | Description |
|---|---|---|
href | String | Link to the configure BIOS validation job |
id | Integer | ID of the configure BIOS validation job |
Sample Input and Output When doNotValidateBIOS is True
Sample XML Input
<biosValidationConfiguration>
<configureManagedDevices>
<doNotValidateBIOS>true</doNotValidateBIOS>
</configureManagedDevices>
</biosValidationConfiguration>
Sample XML Output
<task href="/api/space/job-management/jobs/1605688"> <id>1605688</id> </task>
Sample JSON Input
{
"biosValidationConfiguration": {
"configureManagedDevices": { "doNotValidateBIOS": "true" }
}
}
Sample JSON Output
{
"task": {
"-href": "/api/space/job-management/jobs/1605688",
"id": "1605688"
}
}
Sample Input and Output on Newly Discovered DevicesWhen doNotValidateBIOS is False
Sample XML Input
<biosValidationConfiguration>
<configureManagedDevices>
<validateBIOS>true</validateBIOS>
<applyToAllDevices>true</applyToAllDevices>
</configureManagedDevices>
<minimumDaysBetweenBIOSValidations>30</minimumDaysBetweenBIOSValidations>
</biosValidationConfiguration>
<biosValidationConfiguration>
<configureNewlyDiscoveredDevices>
<validateBIOS>true</validateBIOS>
</configureNewlyDiscoveredDevices>
<minimumDaysBetweenBIOSValidations>25</minimumDaysBetweenBIOSValidations>
</biosValidationConfiguration>Sample XML Output
<servicenowmsg> <msg> BIOS validation configured successfully for newly discovered devices. </msg> </servicenowmsg>
Sample JSON Input for BIOS configuration on newly discovered devices
Sample JSON Input
{
"biosValidationConfiguration": {
"configureNewlyDiscoveredDevices": {
"validateBIOS": "true",
},
"minimumDaysBetweenBIOSValidations": "30"
}
}Sample JSON Output
{
"task": {
"-href": "/api/space/job-management/jobs/1736704",
"id": "1736704"
}
}
Error Codes
Message | Description |
|---|---|
400 BIOS Legal Notice is not accepted | BIOS Legal Notice is not yet accepted. View and accept the BIOS Legal notice at /api/juniper/servicenow/device-analysis/BIOSValidations/ BIOSLegalNotice and then try to configure BIOS validation. |
400 Configuration on End Customer set up | Configuring BIOS validation is not allowed on Junos Space Service Now configured in the End Customer mode. |
400 Invalid input of minimumDaysBetween BIOSValidations | Minimum Interval between BIOS file collection should be between 15 and 365 days. |
