v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1437208153.9 KB

Describes the findings that are specified by the ARNs of the findings.

post/#X-Amz-Target=InspectorService.DescribeFindings

Headers

X-Amz-Target'InspectorService.DescribeFindings' required

Request body

findingArnsArn[] required

The ARN that specifies the finding that you want to describe.

locale'EN_US'

The locale into which you want to translate a finding description, recommendation, and the short description that identifies the finding.

Response

Success

failedItemsobject required

Finding details that cannot be described. An error code is provided for each failed item.

Example response

{
  "failedItems": {},
  "findings": [
    {
      "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4",
      "assetAttributes": {
        "ipv4Addresses": [],
        "schemaVersion": 1
      },
      "assetType": "ec2-instance",
      "attributes": [],
      "confidence": 10,
      "createdAt": "1458680301.37",
      "description": "Amazon Inspector did not find any potential security issues during this assessment.",
      "indicatorOfCompromise": false,
      "numericSeverity": 0,
      "recommendation": "No remediation needed.",
      "schemaVersion": 1,
      "service": "Inspector",
      "serviceAttributes": {
        "assessmentRunArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE",
        "rulesPackageArn": "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP",
        "schemaVersion": 1
      },
      "severity": "Informational",
      "title": "No potential security issues found",
      "updatedAt": "1458680301.37",
      "userAttributes": []
    }
  ]
}