本文へジャンプします。

ニフクラ ヘルプ

脆弱性スキャン:DescribeScanHistories

処理概要

スキャン実行履歴一覧を取得します。
スキャンテンプレート名を指定した場合は、対象スキャンテンプレート名のレコードのみを取得します。

リクエスト

Header
ヘッダー名 説明
X-Amz-Target APIバージョン(2017-02-23)とアクション(DescribeScanHistories)を.(ドット)で連結した文字列
Parameters
パラメータ名 必須 タイプ 説明 デフォルト
ScanTemplateName   string スキャンテンプレート名 ””
StartTime   string スキャン開始時間の取得開始日時 ””
EndTime   string スキャン開始時間の取得終了日時 ””
Request Syntax
{
  "ScanTemplateName": "string",
  "StartTime": "string",
  "EndTime":"string"
}

レスポンス

Response Elements
要素名 タイプ 説明
RequestID string リクエストID
ScanHistories array スキャン実行履歴配列
Response Syntax
{
  "RequestID":"string",
  "ScanHistories": [
    {
      "ScanHistoryUUID": "string",
      "Status": "string",
      "StartTime": "datetime",
      "EndTime": "datetime",
      "ScannedScanTargets": [
        {
          "Region": "string",
          "InstanceUniqueId": "string"
        }
      ],
      "UnScannedScanTargets": [
        {
          "Region": "string",
          "InstanceUniqueId": "string"
        }
      ],
      "ScanTemplateName": "string",
      "ScanResultSummary": {
        "NumberOfCritical": 0,
        "NumberOfHigh":     0,
        "NumberOfMedium":   0,
        "NumberOfLaw":      0,
        "NumberOfNone":     0
      }
    }
  ]
}

APIリクエストの例

POST / HTTP/1.1
Host: vss.api.cloud.nifty.com
User-Agent: curl/7.19.7 (x86_64-redhat-linux-gnu) libcurl/7.19.7 NSS/3.19.1 Basic ECC zlib/1.2.3 libidn/1.18 libssh2/1.4.2
Content-Type: application/json;charset=UTF-8
X-Amz-Target: 2017-02-23.DescribeScanHistories
x-amz-date: 20160805T093953Z
Authorization: AUTHPARAMS
Content-Length: 37

{
  "ScanTemplateName": "ExampleScanTemplate"
}


HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Fri, 05 Aug 2016 10:40:37 GMT

{
  "RequestID":"325c99e4-92ee-4430-9a8f-822d87738a72",
  "ScanHistories":[
    {
      "ScanHistoryUUID":"8ff3f74b-4be4-4866-b141-4091a0bcec29",
      "StartTime":"2016-08-19T00:54:02Z",
      "EndTime":"2016-08-19T00:58:03",
      "Status":"completed",
      "ScannedScanTargets": [
        {
          "Region": "east-1",
          "InstanceUniqueId": "sample"
        }
      ],
      "UnScanndScanTargets": [],
      "ScanTemplateName": "ExampleScanTemplate",
      "ScanResultSummary": {
        "NumberOfCritical": 0,
        "NumberOfHigh": 1,
        "NumberOfMedium": 2,
        "NumberOfLaw": 3,
        "NumberOfNone": 4
      }
    }
  ]
}

推奨画面サイズ 1024×768 以上