Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    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.

    Modified: 2016-08-10