Run Connector

[POST] /qps/rest/2.0/run/am/assetdataconnector

[POST] /qps/rest/2.0/run/am/assetdataconnector/<id>

Request that one or more asset data connectors are run. The connectors may be run immediately, or queued to run when there is capacity. The response will almost always indicate that the connector is pending. Use GET calls to monitor the status of connectors.



Permissions required - Managers with Full Scope.

Sample 1 - Run a single connectorSample 1 - Run a single connector

API request

curl -n -u "USERNAME:PASSWORD" "<qualys_base_url>/qps/rest/2.0/run/am/assetdataconnector/12345"      
    

Response

<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/xsd/2.0/am/asset_data_connector.xsd">
    <responseCode>SUCCESS</responseCode>
    <count>1</count>
    <hasMoreRecords>false</hasMoreRecords>
    <data>
        <AssetDataConnector>
            <id>12345</id>
            <name>DB1</name>
            <lastSync>2014-11-26T08:44:05Z</lastSync>
            <lastError />
            <connectorState>SUCCESS</connectorState>
            <type>AWS</type>
            <defaultTags>
                <list>
                    <TagSimple>
                        <id>3</id>
                        <name>USA</name>
                    </TagSimple>
                </list>
            </defaultTags>
            <activation>
                <ActivationModule>VM</ActivationModule>
                <ActivationModule>PC</ActivationModule>
            </activation>
        </AssetDataConnector>
    </data>
</ServiceResponse>      
    

Sample 2 - Re-run all errored connectorsSample 2 - Re-run all errored connectors

Type your dropdown text here

API request

curl -u "USERNAME:PASSWORD" -H "content-type: text/xml" -X "POST" --data-binary @- "<qualys_base_url>/qps/rest/2.0/run/am/assetdataconnector" < file.xml
    

Response

<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/xsd/2.0/am/asset_data_connector.xsd">
    <responseCode>SUCCESS</responseCode>
    <count>13</count>    <hasMoreRecords>false</hasMoreRecords>
    <data>
        <AssetDataConnector>
            <id>12345</id>
            <name>DB1</name>
            <lastSync>2014-11-26T08:44:05Z</lastSync>
...
    
            <AssetDataConnector>
                <id>12346</id>
                <name>DB2</name>
                <lastSync>2015-01-07T01:50:05Z</lastSync>
...      
    

XSD

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