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 All PHDs by PHD Device Configuration ID

    Use this API to retrieve metadata information of product health data (PHD) collected from a device.

    URI

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

    URI Parameters

    Parameter

    Type

    Required

    Description

    phdDeviceConfigurationsId

    Integer

    Yes

    ID of the device in a PHDC configuration from which PHD metadata information is to be retrieved

    Consumes

    None

    Produces

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

    Response Elements

    Element

    Type

    Description

    uri

    String

    URI of the PHD collection

    device

    String

    Device from which the PHD was collected

    phd

    phd

    A PHD file

    key

    Integer

    ID of the PHD file

    fileName

    String

    Name of the PHD file

    fileSize

    Integer

    Size of the PHD file in Bytes

    receivedTime

    String

    Date and time the PHD file was created

    readStatus

    String

    Status of reading PHD from the device to create PHD file

    Possible values:

    • Not Received—Service Now has not yet collected PHD from the device.
    • Success—Service Now has successfully collected PHD from the device.
    • Failure—Service Now failed to collect PHD from the device.
    • No Longer Available—PHD is no longer available on the device.
    • Successfully Deleted—PHD is successfully deleted from the device after collecting by Service Now
    • Reading from Device—Service Now is currently reading PHD from the device.
    • Read Complete—Service Now has completed reading PHD from the device.
    • Processing—Service Now is processing the PHD to create PHD files.

    uploadStatus

    String

    Status of uploading PHD files to Juniper Support System (JSS)

    • Not Uploaded—Service Now has not yet uploaded PHD files to JSS.
    • Success—Service Now has successfully uploaded PHD files to JSS.
    • Failure—Upload of PHD files to JSS failed.
    • Uploading—Service Now is currently uploading PHD files to JSS.

    phdcName

    String

    Name of the PHDC configuration through which the PHD was collected

    Sample Output

    Sample XML Output

    <phds uri="/api/juniper/servicenow/device-analysis/phdDeviceConfigurations/35643/phds" size="2">
       <device href="/api/juniper/servicenow/device-management/devices/35116" key="35116"/>
       <phd key="917811" href="/api/juniper/servicenow/device-analysis/phds/917811">
          <fileName>ex-4200-sn1_phdc_jmb_ais_health_20150404_102011.txt</fileName>
          <fileSize>N/A</fileSize>
          <receivedTime>2015-07-26 20:32:43 UTC</receivedTime>
          <readStatus>Not Received</readStatus>
          <uploadStatus>Not Uploaded</uploadStatus>
          <phdcName>EX-Group</phdcName>
       </phd>
       <phd key="917845" href="/api/juniper/servicenow/device-analysis/phds/917845">
          <fileName>ex-4200-sn1_phdc_jmb_ais_health_20150404_112009.txt</fileName>
          <fileSize>N/A</fileSize>
          <receivedTime>2015-07-26 21:32:45 UTC</receivedTime>
          <readStatus>Not Received</readStatus>
          <uploadStatus>Not Uploaded</uploadStatus>
          <phdcName>EX-Group</phdcName>
       </phd>
    

    Sample JSON Output

    {
      "phds": {
        "@uri": "/api/juniper/servicenow/device-analysis/phdDeviceConfigurations/35643/phds",
        "@size": "2",
        "device": {
          "@href": "/api/juniper/servicenow/device-management/devices/35116",
          "@key": "35116"
        },
        "phd": [
          {
            "@key": "917811",
            "@href": "/api/juniper/servicenow/device-analysis/phds/917811",
            "fileName": "ex-4200-sn1_phdc_jmb_ais_health_20150404_102011.txt",
            "fileSize": "N/A",
            "receivedTime": "2015-07-26 20:32:43 UTC",
            "readStatus": "Not Received",
            "uploadStatus": "Not Uploaded",
            "phdcName": "EX-Group"
          },
          {
            "@key": "917845",
            "@href": "/api/juniper/servicenow/device-analysis/phds/917845",
            "fileName": "ex-4200-sn1_phdc_jmb_ais_health_20150404_112009.txt",
            "fileSize": "N/A",
            "receivedTime": "2015-07-26 21:32:45 UTC",
            "readStatus": "Not Received",
            "uploadStatus": "Not Uploaded",
            "phdcName": "EX-Group"
          },
        ]
      }
    }
    

    Modified: 2016-08-11