Get Asset Information for a Single Agent

[GET] /qps/rest/2.0/get/am/hostasset/:id

Returns details about a specific cloud agent in the user’s account.

Where “id” (Required) is the ID of the host asset.

Permissions required - User must have CA module enabled and have "API ACCESS” permission.

Input ParametersInput Parameters

There are no input parameters.

Sample - Get agent asset info for a single agentSample - Get agent asset info for a single agent

API request

curl -u "USERNAME:PASSWORD" -X "GET" -H "Content-Type: text/xml"
<qualys_base_url>/qps/rest/2.0/get/am/hostasset/2872638
    

Response

<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/portal-api/xsd/2.0/am/hostasset.xsd">
    <responseCode>SUCCESS</responseCode>
    <count>1</count>
    <hasMoreRecords>false</hasMoreRecords>
    <data>
        <HostAsset>
            <id>5214017</id>
            <name>113080-T450</name>
            <created>2018-04-12T07:23:41Z</created>
            <modified>2018-04-18T11:39:50Z</modified>
            <type>HOST</type>
            <tags>
                <list>
                    <TagSimple>
                        <id>7584632</id>
                        <name>Cloud Agent</name>
                    </TagSimple>
                </list>
            </tags>
            <sourceInfo>
                <list>
                    <AssetSource/>
                </list>
            </sourceInfo>
            <qwebHostId>140995</qwebHostId>
            <lastComplianceScan>2017-04-
             18T11:00:57Z</lastComplianceScan>
            <lastVulnScan>2018-04-18T11:00:57Z</lastVulnScan>
            <lastSystemBoot>2018-04-17T15:16:15Z</lastSystemBoot>
            <lastLoggedOnUser>CORP\rkumar</lastLoggedOnUser>
            <domain>corp.qualys.com</domain>
            <fqdn>113080-T450.corp.qualys.com</fqdn>
            <os>Microsoft Windows 10 Enterprise 10.0.10586 N/A
             Build 10586</os>
            <dnsHostName>113080-T450</dnsHostName>
            <agentInfo>
                <agentVersion>1.5.6.45</agentVersion>
                <agentId>33889e67-d898-4f74-9f19-
                 27ae2265aedc</agentId>
                <status>STATUS_ACTIVE</status>
                <lastCheckedIn>2017-04-18T11:39:29Z</lastCheckedIn>
                <connectedFrom>999.999.999.999</connectedFrom>
                <location>Redwood City, California United
                 States</location>
                <locationGeoLatitude>37.536540</locationGeoLatitude>
                <locationGeoLongtitude>-
                 122.25838</locationGeoLongtitude>
                <chirpStatus>Inventory Scan Complete</chirpStatus>
                <platform>Windows</platform>
                <activatedModule>AGENT_VM,AGENT_PC</activatedModule>
                <manifestVersion>VULNSIGS-VMPC-2.4.18-
                 3</manifestVersion>
                <agentConfiguration>
                    <id>197208</id>
                    <name>for list</name>
                </agentConfiguration>
                <activationKey>
                    <activationId>1b37b569-9bf6-444f-9330-
                     94535696f272</activationId>
                    <title>my</title>
                </activationKey>
            </agentInfo>
            <netbiosName>113080-T450</netbiosName>
            <networkGuid>6b48277c-0742-61c1-82bb-
             cac0f9c4094a</networkGuid>
            <address>10.0.203.10</address>
            <trackingMethod>QAGENT</trackingMethod>
            <manufacturer>LENOVO</manufacturer>
            <model>20BUA04EIG</model>
            <totalMemory>11984</totalMemory>
            <timezone>+05:30</timezone>
            <biosDescription>LENOVO JBET54WW (1.19 ),
             11/6/2015</biosDescription>
            ...
        
        </HostAsset>
    </data>
</ServiceResponse>      
    

XSD

<platform API server>/qps/xsd/2.0/am/hostasset.xsd