Configure BIOS Validation On Devices
Use this API to enable and configure BIOS validation on all devices managed by Junos Space Service Now.
URI
https://[host]/api/juniper/servicenow/device-management/devices/{id}/ configureBIOSValidation?queue=https://[host]/api/hornet-q/queues/jms.queue.[qname] (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 devices managed by Service Now |
Produces
- application/vnd.juniper.servicenow.device-management.device+xml;version=1
- application/vnd.juniper.servicenow.device-management.device+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>
<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 When doNotValidateBIOS is False
Sample XML Input
<biosValidationConfiguration>
<configureManagedDevices>
<validateBIOS>true</validateBIOS>
<applyToAllDevices>true</applyToAllDevices>
</configureManagedDevices>
<minimumDaysBetweenBIOSValidations>30</minimumDaysBetweenBIOSValidations>
</biosValidationConfiguration>
Sample XML Output
<task href="/api/space/job-management/jobs/1736704"> <id>1736704</id> </task>
Sample JSON Input
{
"biosValidationConfiguration": {
"configureManagedDevices": {
"validateBIOS": "true",
"applyToAllDevices": "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. |
400 Configuration on End Customer devices | BIOS validation configuration cannot be done on end-customer devices. |
