Update Configuration Profile

[POST] /qps/rest/1.0/update/ca/agentconfig

Update a configuration profile in the user’s account.

Permissions required - Managers with full scope. Other users must have these permissions: Access Permission “API Access” and CA Configuration Profile Permission “Edit Configuration Profile”.

Input ParametersInput Parameters

See Input Parameters for Create Configuration Profile

Sample - Update configuration profileSample - Update configuration profile

API request

curl -X POST -H "Content-Type: text/xml" -H "Authorization: Basic AbcdAbcdAbcdAbcdAbcd" -H "X-Requested-With: curl" -H "Cache-Control: no-cache" --data-binary @config_update.xml "<qualys_base_url>/qps/rest/1.0/update/ca/agentconfig/"
Note: “config_update.xml” contains the request POST data.

Contents of config_update.xml

<?xml version="1.0" encoding="UTF-8"?>
<ServiceRequest>
    <data>
        <AgentConfig>
            <id>13002</id>
            <name>thru api - updated</name>
            <description>updated using api</description>
            <priority>2</priority>
            <isDefault>0</isDefault>
            <suspendScanning>false</suspendScanning>
            <tags>
                <includeTags>
                    <list>
                        <ConfigTag>
                            <id>256926</id>
                            <name>CSHAH TEMP tag</name>
                        </ConfigTag>
                    </list>
                </includeTags>
                <includeResolution>ANY</includeResolution>
                <excludeTags>
                    <list/>
                </excludeTags>
                <excludeResolution>ANY</excludeResolution>
                <tagSetUuid>ec78b2ce-74e8-4182-bdaf-8090f2983187</tagSetUuid>
            </tags>
            <blackoutConfig>
                <settings>
                    <list/>
                </settings>
            </blackoutConfig>
            <performanceProfile>
                <settings>
                    <list>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_PROVISION</key>
                            <value>3600</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_UPLOAD_CHANGELIST</key>
                            <value>5</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>FILE_UPLOAD_FRAGMENT_SIZE_IN_KB</key>
                            <value>1024</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>AGENT_LOGGING_LEVEL</key>
                            <value>Verbose</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>THROTTLE_EVENT_COMM_DOWNLOAD</key>
                            <value>20</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_DOWNLOAD_MANIFEST</key>
                            <value>10800</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>THROTTLE_EVENT_SCAN</key>
                            <value>20</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>FILE_DOWNLOAD_FRAGMENT_SIZE_IN_KB</key>
                            <value>1024</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_DOWNLOAD_SELF_PATCH</key>
                            <value>10800</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_EXECUTE_SETUP</key>
                            <value>300</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_DOWNLOAD_SNAPSHOT</key>
                            <value>300</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>THROTTLE_EVENT_COMM_UPLOAD</key>
                            <value>20</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_STATUS</key>
                            <value>900</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_CONFIG</key>
                            <value>10800</value>
                        </PerformanceLevelSettings>
                    </list>
                </settings>
            </performanceProfile>
            <vmScanInterval>
                <dataCollectionInterval>500</dataCollectionInterval>
                <scanDelay>510</scanDelay>
                <scanRandomize>410</scanRandomize>
                <scanOnStartup>false</scanOnStartup>
            </vmScanInterval>
            <pcScanInterval>
                <dataCollectionInterval>851</dataCollectionInterval>
                <scanDelay>500</scanDelay>
                <scanRandomize>500</scanRandomize>
            </pcScanInterval>
        </AgentConfig>
    </data>
</ServiceRequest>

For the Update Configuration Profile API, if the 'settings' tags for performance profile are not provided or provided without any values, the existing settings for performance profile will be retained.

Response

<?xml version="1.0" encoding="UTF-8"?>
<ServiceRequest>
    <data>
        <AgentConfig>
            <id>13002</id>
            <name>thru api - updated</name>
            <description>updated using api</description>
            <priority>2</priority>
            <isDefault>0</isDefault>
            <suspendScanning>false</suspendScanning>
            <tags>
                <includeTags>
                    <list>
                        <ConfigTag>
                            <id>256926</id>
                            <name>CSHAH TEMP tag</name>
                        </ConfigTag>
                    </list>
                </includeTags>
                <includeResolution>ANY</includeResolution>
                <excludeTags>
                    <list/>
                </excludeTags>
                <excludeResolution>ANY</excludeResolution>
                <tagSetUuid>ec78b2ce-74e8-4182-bdaf-8090f2983187</tagSetUuid>
            </tags>
            <blackoutConfig>
                <settings>
                    <list/>
                </settings>
            </blackoutConfig>
            <performanceProfile>
                <settings>
                    <list>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_PROVISION</key>
                            <value>3600</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_UPLOAD_CHANGELIST</key>
                            <value>5</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>FILE_UPLOAD_FRAGMENT_SIZE_IN_KB</key>
                            <value>1024</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>AGENT_LOGGING_LEVEL</key>
                            <value>Verbose</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>THROTTLE_EVENT_COMM_DOWNLOAD</key>
                            <value>20</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_DOWNLOAD_MANIFEST</key>
                            <value>10800</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>THROTTLE_EVENT_SCAN</key>
                            <value>20</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>FILE_DOWNLOAD_FRAGMENT_SIZE_IN_KB</key>
                            <value>1024</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_DOWNLOAD_SELF_PATCH</key>
                            <value>10800</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_EXECUTE_SETUP</key>
                            <value>300</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_DOWNLOAD_SNAPSHOT</key>
                            <value>300</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>THROTTLE_EVENT_COMM_UPLOAD</key>
                            <value>20</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_STATUS</key>
                            <value>900</value>
                        </PerformanceLevelSettings>
                        <PerformanceLevelSettings>
                            <key>INTERVAL_EVENT_CONFIG</key>
                            <value>10800</value>
                        </PerformanceLevelSettings>
                    </list>
                </settings>
            </performanceProfile>
            <securitySetting>
                <vmScanMode>AGENTUSER</vmScanMode>
            </securitySetting>
            <vmScanInterval>
                <dataCollectionInterval>500</dataCollectionInterval>
                <scanDelay>510</scanDelay>
                <scanRandomize>410</scanRandomize>
                <scanOnStartup>false</scanOnStartup>
            </vmScanInterval>
            <pcScanInterval>
                <dataCollectionInterval>851</dataCollectionInterval>
                <scanDelay>500</scanDelay>
                <scanRandomize>500</scanRandomize>
            </pcScanInterval>
        </AgentConfig>
    </data>
</ServiceRequest>

XSD

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