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

    Get BIOS Validation by ID

    Use this API to retrieve data about a specific BIOS validation performed on a device managed by Junos Space Service Now.

    URI

    https://[host]/api/juniper/servicenow/device-analysis/BIOSValidations/{id} (HTTP method = GET)

    URI Parameters

    Parameter

    Type

    Required

    Description

    id

    Integer

    Yes

    ID of the BIOS validation to be retrieved

    Consumes

    None

    Produces

    • application/vnd.juniper.servicenow.device-analysis.biosvalidation+json;version=1
    • application/vnd.juniper.servicenow.device-analysis.biosvalidation+xml;version=1

    Response Elements

    Element

    Type

    Description

    uri

    String

    Link to the BIOS validation resource to be retrieved

    id

    Integer

    ID of BIOS validation

    status

    String

    Status of validating BIOS data received from the device. The possible values are:

    • Pending Submission—Service Now has received data for BIOS validation from the device; the data is yet to be submitted to Juniper Support System (JSS).
    • Pending Case Creation—JSS has received the BIOS validation data from the device; JSS is yet to create a case for the received data.
    • Case Created—JSS has created a case for the BIOS validation data received for the device.
    • Case Creation Failed—JSS failed to create a case for the BIOS validation data received from the device.
    • Submission Failed—Service Now is unable to submit the BIOS validation data to JSS.
    • Validation Success—Validation of BIOS data by JSS was successful.
    • Out for Extended Review— BIOS validation encountered issues and the BIOS data is sent to the device team for further review.

    occurred

    String

    Date and time when the BIOS data was received from the device for BIOS integrity check

    entity

    String

    Routing Engine of the device from which the data for BIOS validation was received.

    For a device with dual RE, the values are re0 and re1.

    device

    String

    Device from which the data for BIOS validation was received

    organization

    String

    Organization from which data for BIOS validation was received

    deviceGroup

    String

    Device group of the organization from which the data for BIOS validation was received

    Sample Output

    Sample XML Output

    <bios-validation uri="/api/juniper/servicenow/device-analysis/BIOSValidations/786473">
       <method href="/api/juniper/servicenow/device-analysis/BIOSValidations/786473/export"/>
       <id>786473</id>
       <status>Pending Submission</status>
       <occurred>2014-12-17 20:37:06 IST</occurred>
       <entity>re1</entity>
       <device href="/api/juniper/servicenow/device-management/devices/65545">
          <id>65545</id>
          <serialNumber>JN11742FFAFB</serialNumber>
          <ipAddr>192.0.2.127</ipAddr>
          <product>MX480</product>
          <platform>junos</platform>
          <hostName>mx-480-sn2</hostName>
          <release>12.3R6.6</release>
          <version>R6</version>
       </device>
       <organization href="/api/juniper/servicenow/organization-management/organization/65541">
          <id>65541</id>
          <name>TestOrg</name>
       </organization>
       <deviceGroup href="/api/juniper/servicenow/device-group-management/deviceGroup/65542">
          <id>65542</id>
          <name>Default for TestOrg</name>
       </deviceGroup>
    </bios-validation>
    

    Sample JSON Output

    {
      "bios-validation": {
        "@uri": "/api/juniper/servicenow/device-analysis/BIOSValidations/786473",
        "method": {
          "@href": "/api/juniper/servicenow/device-analysis/BIOSValidations/786473/export"
        },
        "id": 786473,
        "status": "Pending Submission",
        "occurred": "2014-12-17 20:37:06 IST",
        "entity": "re1",
        "device": {
          "@href": "/api/juniper/servicenow/device-management/devices/65545",
          "id": 65545,
          "serialNumber": "JN11742FFAFB",
          "ipAddr": "192.0.2.127",
          "product": "MX480",
          "platform": "junos",
          "hostName": "mx-480-sn2",
          "release": "12.3R6.6",
          "version": "R6"
        },
        "organization": {
          "@href": "/api/juniper/servicenow/organization-management/organization/65541",
          "id": 65541,
          "name": "TestOrg"
        },
        "deviceGroup": {
          "@href": "/api/juniper/servicenow/device-group-management/deviceGroup/65542",
          "id": 65542,
          "name": "Default for TestOrg"
        }
      }
    }
    

    Modified: 2016-08-10