rescandynamicscan.do

Veracode APIs

The rescandynamicscan.do call creates a copy of the most recent DynamicDS scan in preparation for rescanning. After this call has completed successfully, use submitdynamicscan.do to start the rescan.

Before using this API, Veracode strongly recommends that you read API Usage and Access Guidelines.

Resource URL

https://analysiscenter.veracode.com/api/5.0/rescandynamicscan.do

Permissions

You need the Upload and Scan API role or the Upload API - Submit Only role to use this call.

Parameters

Name Type Description
app_id

Required

Integer The unique identifier of an application in your portfolio.
flaw_only Boolean If true, the rescan only scans for flaws found in the last scan. If false, the rescan is a full scan. See Using DynamicDS Vulnerability Rescan for more information. Default is true.
scan_name String The name of the DynamicDS scan to repeat. Default is the most recent scan.

HTTPie Example

Examples use the HTTPie command-line tool. See Using HTTPie with the Python Authentication Library.

http --auth-type=veracode_hmac "https://analysiscenter.veracode.com/api/5.0/rescandynamicscan.do" "app_id==<app id>" "flaw_only==true"

HTTPie Results

The rescandynamicscan.do call returns the dynamicrescaninfo XML document, which references the dynamicrescaninfo.xsd schema file. You can use the XSD schema file to validate the XML data. See the dynamicscaninfo.xsd schema documentation.

<?xml version="1.0" encoding="UTF-8"?>

<dynamic_scan_info xmlns:xsi="http&#x3a;&#x2f;&#x2f;www.w3.org&#x2f;2001&#x2f;XMLSchema-instance" 
         xmlns="https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;schema&#x2f;4.0&#x2f;dynamicrescaninfo" 
         xsi:schemaLocation="https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;schema&#x2f;4.0&#x2f;dynamicrescaninfo 
         https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;resource&#x2f;4.0&#x2f;dynamicrescaninfo.xsd" 
         account_id="31755" app_id="600468" scan_id="5105006" error_message="">
   <dynamic_scan scan_id="5105006" scan_name="Vulnerability rescan&#x3a; 2 Oct 2019 Dynamic" scan_status="Incomplete" 
         rescan_type="flaw_only_rescan" target_url="http&#x3a;&#x2f;&#x2f;dvwa.sa.veracode.io&#x2f;" 
         directory_restriction_policy="true" https_http_inclusion="true">
      <contact_information first_name="Joan" last_name="Smythe" telephone="123-456-7890" email="jsmythe&#x40;example.com"/>
      <allowed_hosts>
         <allowed_host host="http&#x3a;&#x2f;&#x2f;dvwa.sa.veracode.io&#x2f;" directory_restriction_policy="dir_and_sub" 
            https_http_inclusion="true"/>
      </allowed_hosts>
      <exclude_urls>
         <exclude_url host="http&#x3a;&#x2f;&#x2f;www.example.com&#x2f;archives&#x2f;" directory_restriction_policy="dir_only" 
            https_http_inclusion="true"/>
      </exclude_urls>
   </dynamic_scan>
</dynamic_scan_info>