Fetch Agent Binary Information

[POST] /qps/rest/1.0/process/ca/binaryinfo

Fetch the agent installer binary information using API.

Permissions required - Managers with full scope. Other users must have these permissions: Access Permission API Access and Asset Management Permission Read Asset.

Input ParametersInput Parameters

Use these parameters to download an installer binary. Depending on the availability for your platform, you will be able to download a particular installer.

Parameter	Mandatory /Optional	Data Type	Description
platform	Mandatory	value	Specify platform type. Valid values are WINDOWS, MACOSX, MACOSX_M_1, LINUX, AIX, LINUX_UBUNTU, LINUX_PPC_64_LE, BSD, SOLARIS_X_86, SOLARIS_SPARC, LINUX_COREOS, LINUX_S_390_X, LINUX_UBUNTU_S_390_X, GENTOO_LINUX, and LINUX_AWSBR. If you provide platform value as "ALL" in the request body, information of all the available binaries for all the platforms will be shown in the response. Platform value is case sensitive.
architecture	Mandatory	value	Specify platform architecture. Valid values are X_86_64, ARM_64, X_64, POWER_5, SPARC, PPC_64_LE, and S_390_X If you provide architecture value as "ALL" in the request body, information of all the available binaries for all the architectures will be shown in the response. Architecture value is case sensitive.

Parameter

Mandatory

/Optional

Data Type

Description

platform

Mandatory

value

Specify platform type. Valid values are WINDOWS, MACOSX, MACOSX_M_1, LINUX, AIX, LINUX_UBUNTU, LINUX_PPC_64_LE, BSD, SOLARIS_X_86, SOLARIS_SPARC, LINUX_COREOS, LINUX_S_390_X, LINUX_UBUNTU_S_390_X, GENTOO_LINUX, and LINUX_AWSBR.

If you provide platform value as "ALL" in the request body, information of all the available binaries for all the platforms will be shown in the response. Platform value is case sensitive.

architecture

Mandatory

value

Specify platform architecture. Valid values are X_86_64, ARM_64, X_64, POWER_5, SPARC, PPC_64_LE, and S_390_X

If you provide architecture value as "ALL" in the request body, information of all the available binaries for all the architectures will be shown in the response. Architecture value is case sensitive.

Sample - Fetch binary information for Windows X86_64Sample - Fetch binary information for Windows X86_64

API request

curl -u fo_username:password -X POST -H "Content-Type: text/xml" -H "X-Requested-With: curl" --data-binary @info_binary.xml "<qualys_base_url>/qps/rest/1.0/process/ca/binaryinfo/"

Request POST data

<?xml version="1.0" encoding="UTF-8"?>
<ServiceRequest>
    <data>
        <BinaryInfo>
            <platform>WINDOWS</platform>
            <architecture>X_86_64</architecture>
        </BinaryInfo>
    </data>
</ServiceRequest>

Response

<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/qps/xsd/1.0/ca/binaryinfo.xsd">
    <responseCode>SUCCESS</responseCode>
    <count>1</count>
    <data>
        <AllBinaryInfo>
            <platforms>
                <Platform>
                    <name>Windows</name>
                    <version>4.1.0.67</version>
                    <hash>Hash-SHA-256 : 00fd45af84c28561757d35edee42cb3a8348c2c4008d526f7d57f32c05ad10bc</hash>
                    <extension>.exe</extension>
                </Platform>
            </platforms>
        </AllBinaryInfo>
    </data>
</ServiceResponse>

Sample - Fetch binary information for All platforms/architecturesSample - Fetch binary information for All platforms/architectures

API request

curl -u fo_username:password -X POST -H "Content-Type: text/xml" -H "X-Requested-With: curl" --data-binary @info_binary.xml "<qualys_base_url>/qps/rest/1.0/process/ca/binaryinfo/"

Request POST data

<?xml version="1.0" encoding="UTF-8"?>
<ServiceRequest>
    <data>
        <BinaryInfo>
            <platform>ALL</platform>
            <architecture>ALL</architecture>
        </BinaryInfo>
    </data>
</ServiceRequest>

Response

<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/qps/xsd/1.0/ca/binaryinfo.xsd">
    <responseCode>SUCCESS</responseCode>
    <count>12</count>
    <data>
        <AllBinaryInfo>
            <platforms>
                <Platform>
                    <name>Windows</name>
                    <version>4.1.0.51</version>
                    <hash>f5c1947925946be884a62aa5dd5f3ba11c3f5b66c3947070b1272927bbbe08cb</hash>
                    <extension>.exe</extension>
                </Platform>
                <Platform>
                    <name>MACOSX</name>
                    <version>3.7.0.55</version>
                    <hash>Hash-SHA-256 : 15f1db35fe28da613f2acaf295c0e10b2d10fbbcb3030f2097a16f9d827b1511</hash>
                    <extension>.pkg</extension>
                </Platform>
                <Platform>
                    <name>Linux</name>
                    <version>4.6.0.56</version>
                    <hash>Hash-SHA-256 : a3ffe919072e6dd048e429c1f443845e321c1105863087c0d4364eb4587c731b</hash>
                    <extension>.rpm</extension>
                </Platform>
                <Platform>
                    <name>LINUX_ARM</name>
                    <version>4.7.2.7</version>
                    <hash>Hash-SHA-256 : f6289bfedb902c8a588cf421c98581a6c412683c0d33b80b5d78429b4cc1722e</hash>
                    <extension>.rpm</extension>
                </Platform>
                <Platform>
                    <name>AIX</name>
                    <version>3.10.0.17</version>
                    <hash>Hash-SHA-256 : 386371c4489e6b7fc9a02289e5071e9b224fdd952937258deb6e7064991a0f1f</hash>
                    <extension>.bff.gz</extension>
                </Platform>
                <Platform>
                    <name>LINUX_UBUNTU</name>
                    <version>4.6.0.56</version>
                    <hash>Hash-SHA-256 : b718956f5c6c5b02ab13bb3a6d4e4874c57f85269b04f8d04aaaebb6d2caf9f8</hash>
                    <extension>.deb</extension>
                </Platform>
                <Platform>
                    <name>LINUX_UBUNTU_ARM</name>
                    <version>4.7.2.7</version>
                    <hash>Hash-SHA-256 : 57a8ef2d58222242e09c7c6072632aab42e5a9f4a51fa33ed6310c986183a75c</hash>
                    <extension>.deb</extension>
                </Platform>
                <Platform>
                    <name>LINUX_PPC64LE</name>
                    <version>2.6.8.28</version>
                    <hash>Hash-SHA-256 : 533f093de6549db60af3f515ca99f1975498b32fd08d81b96267d6946be3ffca</hash>
                    <extension>.rpm</extension>
                </Platform>
                <Platform>
                    <name>BSD</name>
                    <version>3.12.0.6</version>
                    <hash>Hash-SHA-256 : 11f8261a36dd6a208a0914f4a15fedc87be4e6f192458331f43f1dfac371f83a</hash>
                    <extension>.txz</extension>
                </Platform>
                <Platform>
                    <name>SOLARIS_X86</name>
                    <version>3.11.0.7</version>
                    <hash>Hash-SHA-256 : e1f8565417a86d17b0a2da500fce9956af188a13661c252f1f02aca7acf0cedf</hash>
                    <extension>.pkg</extension>
                </Platform>
                <Platform>
                    <name>SOLARIS_SPARC</name>
                    <version>3.11.0.7</version>
                    <hash>Hash-SHA-256 : c8394acb7548b0ee8fd808e305d65b713afb7e76ecea19fe94ff6b2adee7f990</hash>
                    <extension>.pkg</extension>
                </Platform>
                <Platform>
                    <name>LINUX_COREOS</name>
                    <version>3.5.0.20</version>
                    <hash>Hash-SHA-256 : f5700ab7f6d3cd1810d3589fb9b6d01007dc771dc8dea66f8be35e9ad9e3fc3e</hash>
                    <extension>.tar.xz</extension>
                </Platform>
                <Platform>
                    <name>LINUX_S390X</name>
                    <version>3.31.0.14</version>
                    <hash>Hash-SHA-256 : 23242e8ef148d094b8327e1cefd0eac5f1f3b6cc7229b0ad6bf222708af82777</hash>
                    <extension>.rpm</extension>
                </Platform>
                <Platform>
                    <name>LINUX_UBUNTU_S390X</name>
                    <version>3.31.0.14</version>
                    <hash>Hash-SHA-256 : a613ee47ee7990fc2d13be65b369c1fb7d2f4ffc7f26b9afa14e01d64d933453</hash>
                    
                    <extension>.deb</extension>
                </Platform>
                <Platform>
                    <name>GENTOO_LINUX</name>
                    <version>6.0.111.31</version>
                    <hash>Hash-SHA-256 : 
319138290527db36f4401ddaf9bfd0344fe5d6f280983e92a2f9ff2df1ecb768</hash
>
                    <extension>.tar.gz</extension>
                </Platform>
                <Platform>
                    <name>LINUX_AWSBR</name>
                    <version>5.3.1.12</version>
                    <hash>Hash-SHA-256 : 
6121212ab1ab100a1b0cd12121212a1c1234abcd101010cd12xy101abcd13232</hash
>
                </Platform>
            </platforms>
        </AllBinaryInfo>
    </data>
</ServiceResponse>

XSD

<platform API server>/qps/xsd/1.0/ca/binaryInfo.xsd