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. |