GetFindings
Describes Amazon GuardDuty findings specified by finding IDs.
Request Syntax
POST /detector/detectorId/findings/get HTTP/1.1
Content-type: application/json
{
"findingIds": [ "string" ],
"sortCriteria": {
"attributeName": "string",
"orderBy": "string"
}
}URI Request Parameters
The request uses the following URI parameters.
- detectorId
-
The ID of the detector that specifies the GuardDuty service whose findings you want to retrieve.
To find the
detectorIdin the current Region, see the Settings page in the GuardDuty console, or run the ListDetectors API.Length Constraints: Minimum length of 1. Maximum length of 300.
Required: Yes
Request Body
The request accepts the following data in JSON format.
- findingIds
-
The IDs of the findings that you want to retrieve.
Type: Array of strings
Array Members: Minimum number of 0 items. Maximum number of 50 items.
Length Constraints: Minimum length of 1. Maximum length of 300.
Required: Yes
- sortCriteria
-
Represents the criteria used for sorting findings.
Type: SortCriteria object
Required: No
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"findings": [
{
"accountId": "string",
"arn": "string",
"confidence": number,
"createdAt": "string",
"description": "string",
"id": "string",
"partition": "string",
"region": "string",
"resource": {
"accessKeyDetails": {
"accessKeyId": "string",
"principalId": "string",
"userName": "string",
"userType": "string"
},
"containerDetails": {
"containerRuntime": "string",
"id": "string",
"image": "string",
"imagePrefix": "string",
"name": "string",
"securityContext": {
"allowPrivilegeEscalation": boolean,
"privileged": boolean
},
"volumeMounts": [
{
"mountPath": "string",
"name": "string"
}
]
},
"ebsVolumeDetails": {
"scannedVolumeDetails": [
{
"deviceName": "string",
"encryptionType": "string",
"kmsKeyArn": "string",
"snapshotArn": "string",
"volumeArn": "string",
"volumeSizeInGB": number,
"volumeType": "string"
}
],
"skippedVolumeDetails": [
{
"deviceName": "string",
"encryptionType": "string",
"kmsKeyArn": "string",
"snapshotArn": "string",
"volumeArn": "string",
"volumeSizeInGB": number,
"volumeType": "string"
}
]
},
"ecsClusterDetails": {
"activeServicesCount": number,
"arn": "string",
"name": "string",
"registeredContainerInstancesCount": number,
"runningTasksCount": number,
"status": "string",
"tags": [
{
"key": "string",
"value": "string"
}
],
"taskDetails": {
"arn": "string",
"containers": [
{
"containerRuntime": "string",
"id": "string",
"image": "string",
"imagePrefix": "string",
"name": "string",
"securityContext": {
"allowPrivilegeEscalation": boolean,
"privileged": boolean
},
"volumeMounts": [
{
"mountPath": "string",
"name": "string"
}
]
}
],
"definitionArn": "string",
"group": "string",
"launchType": "string",
"startedAt": number,
"startedBy": "string",
"tags": [
{
"key": "string",
"value": "string"
}
],
"createdAt": number,
"version": "string",
"volumes": [
{
"hostPath": {
"path": "string"
},
"name": "string"
}
]
}
},
"eksClusterDetails": {
"arn": "string",
"createdAt": number,
"name": "string",
"status": "string",
"tags": [
{
"key": "string",
"value": "string"
}
],
"vpcId": "string"
},
"instanceDetails": {
"availabilityZone": "string",
"iamInstanceProfile": {
"arn": "string",
"id": "string"
},
"imageDescription": "string",
"imageId": "string",
"instanceId": "string",
"instanceState": "string",
"instanceType": "string",
"launchTime": "string",
"networkInterfaces": [
{
"ipv6Addresses": [ "string" ],
"networkInterfaceId": "string",
"privateDnsName": "string",
"privateIpAddress": "string",
"privateIpAddresses": [
{
"privateDnsName": "string",
"privateIpAddress": "string"
}
],
"publicDnsName": "string",
"publicIp": "string",
"securityGroups": [
{
"groupId": "string",
"groupName": "string"
}
],
"subnetId": "string",
"vpcId": "string"
}
],
"outpostArn": "string",
"platform": "string",
"productCodes": [
{
"productCodeId": "string",
"productCodeType": "string"
}
],
"tags": [
{
"key": "string",
"value": "string"
}
]
},
"kubernetesDetails": {
"kubernetesUserDetails": {
"groups": [ "string" ],
"impersonatedUser": {
"groups": [ "string" ],
"username": "string"
},
"sessionName": [ "string" ],
"uid": "string",
"username": "string"
},
"kubernetesWorkloadDetails": {
"containers": [
{
"containerRuntime": "string",
"id": "string",
"image": "string",
"imagePrefix": "string",
"name": "string",
"securityContext": {
"allowPrivilegeEscalation": boolean,
"privileged": boolean
},
"volumeMounts": [
{
"mountPath": "string",
"name": "string"
}
]
}
],
"hostIPC": boolean,
"hostNetwork": boolean,
"hostPID": boolean,
"name": "string",
"namespace": "string",
"serviceAccountName": "string",
"type": "string",
"uid": "string",
"volumes": [
{
"hostPath": {
"path": "string"
},
"name": "string"
}
]
}
},
"lambdaDetails": {
"description": "string",
"functionArn": "string",
"functionName": "string",
"functionVersion": "string",
"lastModifiedAt": number,
"revisionId": "string",
"role": "string",
"tags": [
{
"key": "string",
"value": "string"
}
],
"vpcConfig": {
"securityGroups": [
{
"groupId": "string",
"groupName": "string"
}
],
"subnetIds": [ "string" ],
"vpcId": "string"
}
},
"rdsDbInstanceDetails": {
"dbClusterIdentifier": "string",
"dbInstanceArn": "string",
"dbInstanceIdentifier": "string",
"engine": "string",
"engineVersion": "string",
"tags": [
{
"key": "string",
"value": "string"
}
]
},
"rdsDbUserDetails": {
"application": "string",
"authMethod": "string",
"database": "string",
"ssl": "string",
"user": "string"
},
"resourceType": "string",
"s3BucketDetails": [
{
"arn": "string",
"createdAt": number,
"defaultServerSideEncryption": {
"encryptionType": "string",
"kmsMasterKeyArn": "string"
},
"name": "string",
"owner": {
"id": "string"
},
"publicAccess": {
"effectivePermission": "string",
"permissionConfiguration": {
"accountLevelPermissions": {
"blockPublicAccess": {
"blockPublicAcls": boolean,
"blockPublicPolicy": boolean,
"ignorePublicAcls": boolean,
"restrictPublicBuckets": boolean
}
},
"bucketLevelPermissions": {
"accessControlList": {
"allowsPublicReadAccess": boolean,
"allowsPublicWriteAccess": boolean
},
"blockPublicAccess": {
"blockPublicAcls": boolean,
"blockPublicPolicy": boolean,
"ignorePublicAcls": boolean,
"restrictPublicBuckets": boolean
},
"bucketPolicy": {
"allowsPublicReadAccess": boolean,
"allowsPublicWriteAccess": boolean
}
}
}
},
"s3ObjectDetails": [
{
"eTag": "string",
"hash": "string",
"key": "string",
"objectArn": "string",
"versionId": "string"
}
],
"tags": [
{
"key": "string",
"value": "string"
}
],
"type": "string"
}
]
},
"schemaVersion": "string",
"service": {
"action": {
"actionType": "string",
"awsApiCallAction": {
"affectedResources": {
"string" : "string"
},
"api": "string",
"callerType": "string",
"domainDetails": {
"domain": "string"
},
"errorCode": "string",
"remoteAccountDetails": {
"accountId": "string",
"affiliated": boolean
},
"remoteIpDetails": {
"city": {
"cityName": "string"
},
"country": {
"countryCode": "string",
"countryName": "string"
},
"geoLocation": {
"lat": number,
"lon": number
},
"ipAddressV4": "string",
"ipAddressV6": "string",
"organization": {
"asn": "string",
"asnOrg": "string",
"isp": "string",
"org": "string"
}
},
"serviceName": "string",
"userAgent": "string"
},
"dnsRequestAction": {
"blocked": boolean,
"domain": "string",
"domainWithSuffix": "string",
"protocol": "string"
},
"kubernetesApiCallAction": {
"namespace": "string",
"parameters": "string",
"remoteIpDetails": {
"city": {
"cityName": "string"
},
"country": {
"countryCode": "string",
"countryName": "string"
},
"geoLocation": {
"lat": number,
"lon": number
},
"ipAddressV4": "string",
"ipAddressV6": "string",
"organization": {
"asn": "string",
"asnOrg": "string",
"isp": "string",
"org": "string"
}
},
"requestUri": "string",
"resource": "string",
"resourceName": "string",
"sourceIPs": [ "string" ],
"statusCode": number,
"subresource": "string",
"userAgent": "string",
"verb": "string"
},
"kubernetesPermissionCheckedDetails": {
"allowed": boolean,
"namespace": "string",
"resource": "string",
"verb": "string"
},
"kubernetesRoleBindingDetails": {
"kind": "string",
"name": "string",
"roleRefKind": "string",
"roleRefName": "string",
"uid": "string"
},
"kubernetesRoleDetails": {
"kind": "string",
"name": "string",
"uid": "string"
},
"networkConnectionAction": {
"blocked": boolean,
"connectionDirection": "string",
"localIpDetails": {
"ipAddressV4": "string",
"ipAddressV6": "string"
},
"localPortDetails": {
"port": number,
"portName": "string"
},
"protocol": "string",
"remoteIpDetails": {
"city": {
"cityName": "string"
},
"country": {
"countryCode": "string",
"countryName": "string"
},
"geoLocation": {
"lat": number,
"lon": number
},
"ipAddressV4": "string",
"ipAddressV6": "string",
"organization": {
"asn": "string",
"asnOrg": "string",
"isp": "string",
"org": "string"
}
},
"remotePortDetails": {
"port": number,
"portName": "string"
}
},
"portProbeAction": {
"blocked": boolean,
"portProbeDetails": [
{
"localIpDetails": {
"ipAddressV4": "string",
"ipAddressV6": "string"
},
"localPortDetails": {
"port": number,
"portName": "string"
},
"remoteIpDetails": {
"city": {
"cityName": "string"
},
"country": {
"countryCode": "string",
"countryName": "string"
},
"geoLocation": {
"lat": number,
"lon": number
},
"ipAddressV4": "string",
"ipAddressV6": "string",
"organization": {
"asn": "string",
"asnOrg": "string",
"isp": "string",
"org": "string"
}
}
}
]
},
"rdsLoginAttemptAction": {
"LoginAttributes": [
{
"application": "string",
"failedLoginAttempts": number,
"successfulLoginAttempts": number,
"user": "string"
}
],
"remoteIpDetails": {
"city": {
"cityName": "string"
},
"country": {
"countryCode": "string",
"countryName": "string"
},
"geoLocation": {
"lat": number,
"lon": number
},
"ipAddressV4": "string",
"ipAddressV6": "string",
"organization": {
"asn": "string",
"asnOrg": "string",
"isp": "string",
"org": "string"
}
}
}
},
"additionalInfo": {
"type": "string",
"value": "string"
},
"archived": boolean,
"count": number,
"detection": {
"anomaly": {
"profiles": {
"string" : {
"string" : [
{
"observations": {
"text": [ "string" ]
},
"profileSubtype": "string",
"profileType": "string"
}
]
}
},
"unusual": {
"behavior": {
"string" : {
"string" : {
"observations": {
"text": [ "string" ]
},
"profileSubtype": "string",
"profileType": "string"
}
}
}
}
}
},
"detectorId": "string",
"ebsVolumeScanDetails": {
"scanCompletedAt": number,
"scanDetections": {
"highestSeverityThreatDetails": {
"count": number,
"severity": "string",
"threatName": "string"
},
"scannedItemCount": {
"files": number,
"totalGb": number,
"volumes": number
},
"threatDetectedByName": {
"itemCount": number,
"shortened": boolean,
"threatNames": [
{
"filePaths": [
{
"fileName": "string",
"filePath": "string",
"hash": "string",
"volumeArn": "string"
}
],
"itemCount": number,
"name": "string",
"severity": "string"
}
],
"uniqueThreatNameCount": number
},
"threatsDetectedItemCount": {
"files": number
}
},
"scanId": "string",
"scanStartedAt": number,
"scanType": "string",
"sources": [ "string" ],
"triggerFindingId": "string"
},
"eventFirstSeen": "string",
"eventLastSeen": "string",
"evidence": {
"threatIntelligenceDetails": [
{
"threatFileSha256": "string",
"threatListName": "string",
"threatNames": [ "string" ]
}
]
},
"featureName": "string",
"malwareScanDetails": {
"threats": [
{
"itemPaths": [
{
"hash": "string",
"nestedItemPath": "string"
}
],
"name": "string",
"source": "string"
}
]
},
"resourceRole": "string",
"runtimeDetails": {
"context": {
"addressFamily": "string",
"commandLineExample": "string",
"fileSystemType": "string",
"flags": [ "string" ],
"ianaProtocolNumber": number,
"ldPreloadValue": "string",
"libraryPath": "string",
"memoryRegions": [ "string" ],
"modifiedAt": number,
"modifyingProcess": {
"euid": number,
"executablePath": "string",
"executableSha256": "string",
"lineage": [
{
"euid": number,
"executablePath": "string",
"name": "string",
"namespacePid": number,
"parentUuid": "string",
"pid": number,
"startTime": number,
"userId": number,
"uuid": "string"
}
],
"name": "string",
"namespacePid": number,
"parentUuid": "string",
"pid": number,
"pwd": "string",
"startTime": number,
"user": "string",
"userId": number,
"uuid": "string"
},
"moduleFilePath": "string",
"moduleName": "string",
"moduleSha256": "string",
"mountSource": "string",
"mountTarget": "string",
"releaseAgentPath": "string",
"runcBinaryPath": "string",
"scriptPath": "string",
"serviceName": "string",
"shellHistoryFilePath": "string",
"socketPath": "string",
"targetProcess": {
"euid": number,
"executablePath": "string",
"executableSha256": "string",
"lineage": [
{
"euid": number,
"executablePath": "string",
"name": "string",
"namespacePid": number,
"parentUuid": "string",
"pid": number,
"startTime": number,
"userId": number,
"uuid": "string"
}
],
"name": "string",
"namespacePid": number,
"parentUuid": "string",
"pid": number,
"pwd": "string",
"startTime": number,
"user": "string",
"userId": number,
"uuid": "string"
},
"threatFilePath": "string",
"toolCategory": "string",
"toolName": "string"
},
"process": {
"euid": number,
"executablePath": "string",
"executableSha256": "string",
"lineage": [
{
"euid": number,
"executablePath": "string",
"name": "string",
"namespacePid": number,
"parentUuid": "string",
"pid": number,
"startTime": number,
"userId": number,
"uuid": "string"
}
],
"name": "string",
"namespacePid": number,
"parentUuid": "string",
"pid": number,
"pwd": "string",
"startTime": number,
"user": "string",
"userId": number,
"uuid": "string"
}
},
"serviceName": "string",
"userFeedback": "string"
},
"severity": number,
"title": "string",
"type": "string",
"updatedAt": "string"
}
]
}Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
Errors
For information about the errors that are common to all actions, see Common Errors.
- BadRequestException
-
A bad request exception object.
HTTP Status Code: 400
- InternalServerErrorException
-
An internal server error exception object.
HTTP Status Code: 500
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
