テンプレートを基にしたスキャン・ジョブの作成

この REST サービスは、特定のテンプレートを基にして、スキャン・ジョブ、および関連するレポート・パックを作成します。POST データを使用して、名前フィールドと説明フィールドがサーバーに提供されます。

HTTPS 方式

POST

サービス形式

ジョブおよびレポート・パックをルート・フォルダーに作成する場合: /services/folderitems?templateid=<id>

ジョブおよびレポート・パックを特定のフォルダーに作成する場合: /services/folders/<folderId>/folderitems?templateid=<id>

照会ストリング・パラメーター

  • (必須) templateid: スキャン・テンプレート ID (テンプレート・リストの取得を参照。)
    注: 「templateid」は、テンプレート・ディレクトリーまたはそのいずれかのサブフォルダー内で自分がアクセスできる、有効な ID にする必要があります。
  • (オプション) appid: アプリケーション ID。ジョブをアプリケーションに関連付けるために使用されます。

POST データ

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

name: スキャンの名前

説明: スキャンの説明

ペイロード: これはオプション・データです。これは、「AppScan Enterprise ジョブの結果を構成済みエンドポイント URL に非同期に通知」機能でのみ必要です。詳細については、https://support.hcl-software.com/csm?id=kb_article&sysparm_article=KB0011579 を参照してください。

戻り値

作成された新規コンテンツ・スキャン・ジョブおよびレポート・パックの XML。

例:

要求:

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

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

応答:

<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>				  	  

詳しくは、文書化されたスキーマを参照してください。

次に行うこと

ジョブ・オプションの構成