Création d'un travail d'examen en se basant sur des modèles

Ce service REST crée un travail d'examen et un groupe de rapports associé en se basant sur un modèle spécifique. Les zones de nom et de description sont fournies au serveur en utilisant les données POST.

Méthode HTTPS

POST

Format de service

Pour créer un travail et un groupe de rapports dans le dossier racine : /services/folderitems?templateid=<id>

Pour créer un travail et un groupe de rapports dans un dossier spécifique : /services/folders/<folderId>/folderitems?templateid=<id>

Paramètres de la chaîne de requête

  • (Obligatoire) templateid : ID modèle d'examen (voir Extraction d'une liste de modèles.)
    Remarque : L'"ID modèle" doit être un ID valide auquel vous avez accès dans le répertoire Modèles ou l'un de ses sous-dossiers.
  • (Facultatif) appid : ID application. Utilisé pour associer le travail à une application.

Données POST

Content-Type : application/x-www-form-urlencoded

Nom: nom de l'examen

description : description de l'examen

payload : cette donnée est facultative. Elle est uniquement requise pour la fonction Envoyer les résultats du travail AppScan Enterprise de manière asynchrone vers l'URL de nœud final configurée. Pour plus d'informations, voir https://support.hcl-software.com/csm?id=kb_article&sysparm_article=KB0011579.

Renvoie

Le travail d'examen de contenu et le XML du groupe de rapports qui ont été créés.

Exemple :

Demande :

POST /services/folderitems?templateid=<templateId>&appid=<appid>

name=<name of scan>&description=<description>

Réponse :

<folder-items>
   <content-scan-job>
     <id>56</id>
     <name>new scan A</name>
     <description>a new scan called A</description>
     <parent href="https://localhost/ase/services/folders/1">
       <id>1</id>
     </parent>
     <contact>Bill Smith</contact>
     <state>
       <id>1</id>
       <name>Ready</name>
     </state>
     <action>
       <id>1</id>
       <name>None</name>
     </action>
     <options href="https://localhost/ase/services/folderitems/56/options" />
   </content-scan-job>
   <report-pack>
     <id>57</id>
     <name>new scan A</name>
     <description>a new scan called A</description>
     <parent href="https://localhost/ase/services/folders/1" />
       <id>1</id>
     </parent>
     <contact>Bill Smith</contact>
     <state>
       <id>1</id>
       <name>Ready</name>
     </state>
     <action>
       <id>1</id>
       <name>None</name>
     </action>
     <reports href="https://localhost/ase/services/folderitems/57/reports">
       <count>4</count>
     </reports>
   </report-pack>
</folder-items>				  	  

Consultez le schéma documenté pour plus de détails.

Que faire ensuite ?

Configuration des options de travail