Findings
The Findings resource represents the repository of findings for your Amazon Macie account. A finding is a detailed report of a potential issue with the security or privacy of an Amazon Simple Storage Service (Amazon S3) general purpose bucket or sensitive data in an S3 object. Each finding provides details such as a severity rating, information about the affected resource, and when and how Macie found the issue. The severity and details of each finding vary depending on the type and nature of the finding. For information about the types of findings that Macie can generate, see Types of findings in the Amazon Macie User Guide.
You can use the Findings resource to retrieve the details of one or more findings for your account. To refine your results, you can use the supported parameters to specify how to sort the results. When you use this resource, you have to specify the unique identifier for each finding to retrieve. To find this identifier, you can use the Finding List resource.
URI
/findings/describe
HTTP methods
POST
Operation ID: GetFindings
Retrieves the details of one or more findings.
Responses | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Status code | Response model | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
200 | GetFindingsResponse | The request succeeded. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
400 | ValidationException | The request failed because the input doesn't satisfy the constraints specified by the service. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
402 | ServiceQuotaExceededException | The request failed because fulfilling the request would exceed one or more service quotas for your account. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
403 | AccessDeniedException | The request was denied because you don't have sufficient access to the specified resource. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
404 | ResourceNotFoundException | The request failed because the specified resource wasn't found. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
409 | ConflictException | The request failed because it conflicts with the current state of the specified resource. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
429 | ThrottlingException | The request failed because you sent too many requests during a certain amount of time. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
500 | InternalServerException | The request failed due to an unknown internal server error, exception, or failure. |
Schemas
Request bodies
{ "findingIds": [ "string" ], "sortCriteria": { "attributeName": "string", "orderBy": enum } }
Response bodies
{ "findings": [ { "accountId": "string", "archived": boolean, "category": enum, "classificationDetails": { "detailedResultsLocation": "string", "jobArn": "string", "jobId": "string", "originType": enum, "result": { "additionalOccurrences": boolean, "customDataIdentifiers": { "detections": [ { "arn": "string", "count": integer, "name": "string", "occurrences": { "cells": [ { "cellReference": "string", "column": integer, "columnName": "string", "row": integer } ], "lineRanges": [ { "end": integer, "start": integer, "startColumn": integer } ], "offsetRanges": [ { "end": integer, "start": integer, "startColumn": integer } ], "pages": [ { "lineRange": { "end": integer, "start": integer, "startColumn": integer }, "offsetRange": { "end": integer, "start": integer, "startColumn": integer }, "pageNumber": integer } ], "records": [ { "jsonPath": "string", "recordIndex": integer } ] } } ], "totalCount": integer }, "mimeType": "string", "sensitiveData": [ { "category": enum, "detections": [ { "count": integer, "occurrences": { "cells": [ { "cellReference": "string", "column": integer, "columnName": "string", "row": integer } ], "lineRanges": [ { "end": integer, "start": integer, "startColumn": integer } ], "offsetRanges": [ { "end": integer, "start": integer, "startColumn": integer } ], "pages": [ { "lineRange": { "end": integer, "start": integer, "startColumn": integer }, "offsetRange": { "end": integer, "start": integer, "startColumn": integer }, "pageNumber": integer } ], "records": [ { "jsonPath": "string", "recordIndex": integer } ] }, "type": "string" } ], "totalCount": integer } ], "sizeClassified": integer, "status": { "code": "string", "reason": "string" } } }, "count": integer, "createdAt": "string", "description": "string", "id": "string", "partition": "string", "policyDetails": { "action": { "actionType": enum, "apiCallDetails": { "api": "string", "apiServiceName": "string", "firstSeen": "string", "lastSeen": "string" } }, "actor": { "domainDetails": { "domainName": "string" }, "ipAddressDetails": { "ipAddressV4": "string", "ipCity": { "name": "string" }, "ipCountry": { "code": "string", "name": "string" }, "ipGeoLocation": { "lat": number, "lon": number }, "ipOwner": { "asn": "string", "asnOrg": "string", "isp": "string", "org": "string" } }, "userIdentity": { "assumedRole": { "accessKeyId": "string", "accountId": "string", "arn": "string", "principalId": "string", "sessionContext": { "attributes": { "creationDate": "string", "mfaAuthenticated": boolean }, "sessionIssuer": { "accountId": "string", "arn": "string", "principalId": "string", "type": "string", "userName": "string" } } }, "awsAccount": { "accountId": "string", "principalId": "string" }, "awsService": { "invokedBy": "string" }, "federatedUser": { "accessKeyId": "string", "accountId": "string", "arn": "string", "principalId": "string", "sessionContext": { "attributes": { "creationDate": "string", "mfaAuthenticated": boolean }, "sessionIssuer": { "accountId": "string", "arn": "string", "principalId": "string", "type": "string", "userName": "string" } } }, "iamUser": { "accountId": "string", "arn": "string", "principalId": "string", "userName": "string" }, "root": { "accountId": "string", "arn": "string", "principalId": "string" }, "type": enum } } }, "region": "string", "resourcesAffected": { "s3Bucket": { "allowsUnencryptedObjectUploads": enum, "arn": "string", "createdAt": "string", "defaultServerSideEncryption": { "encryptionType": enum, "kmsMasterKeyId": "string" }, "name": "string", "owner": { "displayName": "string", "id": "string" }, "publicAccess": { "effectivePermission": enum, "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 } } } }, "tags": [ { "key": "string", "value": "string" } ] }, "s3Object": { "bucketArn": "string", "eTag": "string", "extension": "string", "key": "string", "lastModified": "string", "path": "string", "publicAccess": boolean, "serverSideEncryption": { "encryptionType": enum, "kmsMasterKeyId": "string" }, "size": integer, "storageClass": enum, "tags": [ { "key": "string", "value": "string" } ], "versionId": "string" } }, "sample": boolean, "schemaVersion": "string", "severity": { "description": enum, "score": integer }, "title": "string", "type": enum, "updatedAt": "string" } ] }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
{ "message": "string" }
Properties
AccessControlList
Provides information about the permissions settings of the bucket-level access control list (ACL) for an S3 bucket.
Property | Type | Required | Description |
---|---|---|---|
allowsPublicReadAccess | boolean | False | Specifies whether the ACL grants the general public with read access permissions for the bucket. |
allowsPublicWriteAccess | boolean | False | Specifies whether the ACL grants the general public with write access permissions for the bucket. |
AccessDeniedException
Provides information about an error that occurred due to insufficient access to a specified resource.
Property | Type | Required | Description |
---|---|---|---|
message | string | False | The explanation of the error that occurred. |
AccountLevelPermissions
Provides information about the account-level permissions settings that apply to an S3 bucket.
Property | Type | Required | Description |
---|---|---|---|
blockPublicAccess | False | The block public access settings for the AWS account that owns the bucket. |
ApiCallDetails
Provides information about an API operation that an entity invoked for an affected resource.
Property | Type | Required | Description |
---|---|---|---|
api | string | False | The name of the operation that was invoked most recently and produced the finding. |
apiServiceName | string | False | The URL of the AWS service that provides the operation, for
example: |
firstSeen | string Format: date-time | False | The first date and time, in UTC and extended ISO 8601 format, when any operation was invoked and produced the finding. |
lastSeen | string Format: date-time | False | The most recent date and time, in UTC and extended ISO 8601 format, when the
specified operation ( |
AssumedRole
Provides information about an identity that performed an action on an affected
resource by using temporary security credentials. The credentials were obtained using
the AssumeRole
operation of the AWS Security Token Service (AWS STS) API.
Property | Type | Required | Description |
---|---|---|---|
accessKeyId | string | False | The AWS access key ID that identifies the credentials. |
accountId | string | False | The unique identifier for the AWS account that owns the entity that was used to get the credentials. |
arn | string | False | The Amazon Resource Name (ARN) of the entity that was used to get the credentials. |
principalId | string | False | The unique identifier for the entity that was used to get the credentials. |
sessionContext | False | The details of the session that was created for the credentials, including the entity that issued the session. |
AwsAccount
Provides information about an AWS account and entity that performed an action on an affected resource. The action was performed using the credentials for an AWS account other than your own account.
Property | Type | Required | Description |
---|---|---|---|
accountId | string | False | The unique identifier for the AWS account. |
principalId | string | False | The unique identifier for the entity that performed the action. |
AwsService
Provides information about an AWS service that performed an action on an affected resource.
Property | Type | Required | Description |
---|---|---|---|
invokedBy | string | False | The name of the AWS service that performed the action. |
BlockPublicAccess
Provides information about the block public access settings for an S3 bucket. These settings can apply to a bucket at the account or bucket level. For detailed information about each setting, see Blocking public access to your Amazon S3 storage in the Amazon Simple Storage Service User Guide.
Property | Type | Required | Description |
---|---|---|---|
blockPublicAcls | boolean | False | Specifies whether Amazon S3 blocks public access control lists (ACLs) for the bucket and objects in the bucket. |
blockPublicPolicy | boolean | False | Specifies whether Amazon S3 blocks public bucket policies for the bucket. |
ignorePublicAcls | boolean | False | Specifies whether Amazon S3 ignores public ACLs for the bucket and objects in the bucket. |
restrictPublicBuckets | boolean | False | Specifies whether Amazon S3 restricts public bucket policies for the bucket. |
BucketLevelPermissions
Provides information about the bucket-level permissions settings for an S3 bucket.
Property | Type | Required | Description |
---|---|---|---|
accessControlList | False | The permissions settings of the access control list (ACL) for the bucket. This value is null if an ACL hasn't been defined for the bucket. | |
blockPublicAccess | False | The block public access settings for the bucket. | |
bucketPolicy | False | The permissions settings of the bucket policy for the bucket. This value is null if a bucket policy hasn't been defined for the bucket. |
BucketPermissionConfiguration
Provides information about the account-level and bucket-level permissions settings for an S3 bucket.
Property | Type | Required | Description |
---|---|---|---|
accountLevelPermissions | False | The account-level permissions settings that apply to the bucket. | |
bucketLevelPermissions | False | The bucket-level permissions settings for the bucket. |
BucketPolicy
Provides information about the permissions settings of the bucket policy for an S3 bucket.
Property | Type | Required | Description |
---|---|---|---|
allowsPublicReadAccess | boolean | False | Specifies whether the bucket policy allows the general public to have read access to the bucket. |
allowsPublicWriteAccess | boolean | False | Specifies whether the bucket policy allows the general public to have write access to the bucket. |
BucketPublicAccess
Provides information about the permissions settings that determine whether an S3 bucket is publicly accessible.
Property | Type | Required | Description |
---|---|---|---|
effectivePermission | string Values: | False | Specifies whether the bucket is publicly accessible due to the combination of permissions settings that apply to the bucket. Possible values are:
|
permissionConfiguration | False | The account-level and bucket-level permissions settings for the bucket. |
Cell
Specifies the location of an occurrence of sensitive data in a Microsoft Excel workbook, CSV file, or TSV file.
Property | Type | Required | Description |
---|---|---|---|
cellReference | string | False | The location of the cell, as an absolute cell reference, that contains the
sensitive data, for example |
column | integer Format: int64 | False | The column number of the column that contains the sensitive data. For a Microsoft
Excel workbook, this value correlates to the alphabetical character(s) for a column
identifier, for example: |
columnName | string | False | The name of the column that contains the sensitive data, if available. |
row | integer Format: int64 | False | The row number of the row that contains the sensitive data. |
ClassificationDetails
Provides information about a sensitive data finding and the details of the finding.
Property | Type | Required | Description |
---|---|---|---|
detailedResultsLocation | string | False | The path to the folder or file in Amazon S3 that contains the corresponding sensitive data discovery result for the finding. If a finding applies to a large archive or compressed file, this value is the path to a folder. Otherwise, this value is the path to a file. |
jobArn | string | False | The Amazon Resource Name (ARN) of the classification job that produced the
finding. This value is null if the origin of the finding ( |
jobId | string | False | The unique identifier for the classification job that produced the finding. This
value is null if the origin of the finding ( |
originType | False | Specifies how Amazon Macie found the sensitive data that produced the
finding. Possible values are: | |
result | False | The status and other details of the finding. |
ClassificationResult
Provides the details of a sensitive data finding, including the types, number of occurrences, and locations of the sensitive data that was detected.
Property | Type | Required | Description |
---|---|---|---|
additionalOccurrences | boolean | False | Specifies whether Amazon Macie detected additional occurrences of sensitive data in the S3 object. A finding includes location data for a maximum of 15 occurrences of sensitive data. This value can help you determine whether to investigate additional occurrences of
sensitive data in an object. You can do this by referring to the corresponding
sensitive data discovery result for the finding
( |
customDataIdentifiers | False | The custom data identifiers that detected the sensitive data and the number of occurrences of the data that they detected. | |
mimeType | string | False | The type of content, as a MIME type, that the finding applies to. For example,
|
sensitiveData | Array of type SensitiveDataItem | False | The category, types, and number of occurrences of the sensitive data that produced the finding. |
sizeClassified | integer Format: int64 | False | The total size, in bytes, of the data that the finding applies to. |
status | False | The status of the finding. |
ClassificationResultStatus
Provides information about the status of a sensitive data finding.
Property | Type | Required | Description |
---|---|---|---|
code | string | False | The status of the finding. Possible values are:
|
reason | string | False | A brief description of the status of the finding. This value is null if the status
( Amazon Macie uses this value to notify you of any errors, warnings, or considerations that might impact your analysis of the finding and the affected S3 object. Possible values are:
For information about quotas, supported storage classes, and supported file and storage formats, see Quotas and Supported storage classes and formats in the Amazon Macie User Guide. |
ConflictException
Provides information about an error that occurred due to a versioning conflict for a specified resource.
Property | Type | Required | Description |
---|---|---|---|
message | string | False | The explanation of the error that occurred. |
CustomDataIdentifiers
Provides information about custom data identifiers that produced a sensitive data finding, and the number of occurrences of the data that they detected for the finding.
Property | Type | Required | Description |
---|---|---|---|
detections | Array of type CustomDetection | False | The custom data identifiers that detected the data, and the number of occurrences of the data that each identifier detected. |
totalCount | integer Format: int64 | False | The total number of occurrences of the data that was detected by the custom data identifiers and produced the finding. |
CustomDetection
Provides information about a custom data identifier that produced a sensitive data finding, and the sensitive data that it detected for the finding.
Property | Type | Required | Description |
---|---|---|---|
arn | string | False | The unique identifier for the custom data identifier. |
count | integer Format: int64 | False | The total number of occurrences of the sensitive data that the custom data identifier detected. |
name | string | False | The name of the custom data identifier. |
occurrences | False | The location of 1-15 occurrences of the sensitive data that the custom data identifier detected. A finding includes location data for a maximum of 15 occurrences of sensitive data. |
DefaultDetection
Provides information about a type of sensitive data that was detected by a managed data identifier and produced a sensitive data finding.
Property | Type | Required | Description |
---|---|---|---|
count | integer Format: int64 | False | The total number of occurrences of the type of sensitive data that was detected. |
occurrences | False | The location of 1-15 occurrences of the sensitive data that was detected. A finding includes location data for a maximum of 15 occurrences of sensitive data. | |
type | string | False | The type of sensitive data that was detected. For example,
|
DomainDetails
Provides information about the domain name of the device that an entity used to perform an action on an affected resource.
Property | Type | Required | Description |
---|---|---|---|
domainName | string | False | The name of the domain. |
EncryptionType
The server-side encryption algorithm that was used to encrypt an S3 object or is used by default to encrypt objects that are added to an S3 bucket. Possible values are:
NONE
AES256
aws:kms
UNKNOWN
aws:kms:dsse
FederatedUser
Provides information about an identity that performed an action on an affected
resource by using temporary security credentials. The credentials were obtained using
the GetFederationToken
operation of the AWS Security Token Service (AWS STS) API.
Property | Type | Required | Description |
---|---|---|---|
accessKeyId | string | False | The AWS access key ID that identifies the credentials. |
accountId | string | False | The unique identifier for the AWS account that owns the entity that was used to get the credentials. |
arn | string | False | The Amazon Resource Name (ARN) of the entity that was used to get the credentials. |
principalId | string | False | The unique identifier for the entity that was used to get the credentials. |
sessionContext | False | The details of the session that was created for the credentials, including the entity that issued the session. |
Finding
Provides the details of a finding.
Property | Type | Required | Description |
---|---|---|---|
accountId | string | False | The unique identifier for the AWS account that the finding applies to. This is typically the account that owns the affected resource. |
archived | boolean | False | Specifies whether the finding is archived (suppressed). |
category | False | The category of the finding. Possible values are: | |
classificationDetails | False | The details of a sensitive data finding. This value is null for a policy finding. | |
count | integer Format: int64 | False | The total number of occurrences of the finding. For sensitive data findings, this
value is always |
createdAt | string Format: date-time | False | The date and time, in UTC and extended ISO 8601 format, when Amazon Macie created the finding. |
description | string | False | The description of the finding. |
id | string | False | The unique identifier for the finding. This is a random string that Amazon Macie generates and assigns to a finding when it creates the finding. |
partition | string | False | The AWS partition that Amazon Macie created the finding in. |
policyDetails | False | The details of a policy finding. This value is null for a sensitive data finding. | |
region | string | False | The AWS Region that Amazon Macie created the finding in. |
resourcesAffected | False | The resources that the finding applies to. | |
sample | boolean | False | Specifies whether the finding is a sample finding. A sample finding is a finding that uses example data to demonstrate what a finding might contain. |
schemaVersion | string | False | The version of the schema that was used to define the data structures in the finding. |
severity | False | The severity level and score for the finding. | |
title | string | False | The brief description of the finding. |
type | False | The type of the finding. | |
updatedAt | string Format: date-time | False | The date and time, in UTC and extended ISO 8601 format, when Amazon Macie last updated the finding. For sensitive data findings, this value is the same as
the value for the |
FindingAction
Provides information about an action that occurred for a resource and produced a policy finding.
Property | Type | Required | Description |
---|---|---|---|
actionType | False | The type of action that occurred for the affected resource. This value is
typically | |
apiCallDetails | False | The invocation details of the API operation that an entity invoked for the
affected resource, if the value for the |
FindingActionType
The type of action that occurred for the resource and produced the policy finding:
AWS_API_CALL
FindingActor
Provides information about an entity that performed an action that produced a policy finding for a resource.
Property | Type | Required | Description |
---|---|---|---|
domainDetails | False | The domain name of the device that the entity used to perform the action on the affected resource. | |
ipAddressDetails | False | The IP address and related details about the device that the entity used to perform the action on the affected resource. The details can include information such as the owner and geographic location of the IP address. | |
userIdentity | False | The type and other characteristics of the entity that performed the action on the affected resource. This value is null if the action was performed by an anonymous (unauthenticated) entity. |
FindingCategory
The category of the finding. Possible values are:
CLASSIFICATION
POLICY
FindingType
The type of finding. For details about each type, see Types of findings in the Amazon Macie User Guide. Possible values are:
SensitiveData:S3Object/Multiple
SensitiveData:S3Object/Financial
SensitiveData:S3Object/Personal
SensitiveData:S3Object/Credentials
SensitiveData:S3Object/CustomIdentifier
Policy:IAMUser/S3BucketPublic
Policy:IAMUser/S3BucketSharedExternally
Policy:IAMUser/S3BucketReplicatedExternally
Policy:IAMUser/S3BucketEncryptionDisabled
Policy:IAMUser/S3BlockPublicAccessDisabled
Policy:IAMUser/S3BucketSharedWithCloudFront
GetFindingsRequest
Specifies one or more findings to retrieve.
Property | Type | Required | Description |
---|---|---|---|
findingIds | Array of type string | True | An array of strings that lists the unique identifiers for the findings to retrieve. You can specify as many as 50 unique identifiers in this array. |
sortCriteria | False | The criteria for sorting the results of the request. |
GetFindingsResponse
Provides the results of a request for one or more findings.
Property | Type | Required | Description |
---|---|---|---|
findings | Array of type Finding | False | An array of objects, one for each finding that matches the criteria specified in the request. |
IamUser
Provides information about an AWS Identity and Access Management (IAM) user who performed an action on an affected resource.
Property | Type | Required | Description |
---|---|---|---|
accountId | string | False | The unique identifier for the AWS account that's associated with the IAM user who performed the action. |
arn | string | False | The Amazon Resource Name (ARN) of the principal that performed the action. The last section of the ARN contains the name of the user who performed the action. |
principalId | string | False | The unique identifier for the IAM user who performed the action. |
userName | string | False | The username of the IAM user who performed the action. |
InternalServerException
Provides information about an error that occurred due to an unknown internal server error, exception, or failure.
Property | Type | Required | Description |
---|---|---|---|
message | string | False | The explanation of the error that occurred. |
IpAddressDetails
Provides information about the IP address of the device that an entity used to perform an action on an affected resource.
Property | Type | Required | Description |
---|---|---|---|
ipAddressV4 | string | False | The Internet Protocol version 4 (IPv4) address of the device. |
ipCity | False | The city that the IP address originated from. | |
ipCountry | False | The country that the IP address originated from. | |
ipGeoLocation | False | The geographic coordinates of the location that the IP address originated from. | |
ipOwner | False | The registered owner of the IP address. |
IpCity
Provides information about the city that an IP address originated from.
Property | Type | Required | Description |
---|---|---|---|
name | string | False | The name of the city. |
IpCountry
Provides information about the country that an IP address originated from.
Property | Type | Required | Description |
---|---|---|---|
code | string | False | The two-character code, in ISO 3166-1 alpha-2 format, for the country that the IP
address originated from. For example, |
name | string | False | The name of the country that the IP address originated from. |
IpGeoLocation
Provides geographic coordinates that indicate where a specified IP address originated from.
Property | Type | Required | Description |
---|---|---|---|
lat | number | False | The latitude coordinate of the location, rounded to four decimal places. |
lon | number | False | The longitude coordinate of the location, rounded to four decimal places. |
IpOwner
Provides information about the registered owner of an IP address.
Property | Type | Required | Description |
---|---|---|---|
asn | string | False | The autonomous system number (ASN) for the autonomous system that included the IP address. |
asnOrg | string | False | The organization identifier that's associated with the autonomous system number (ASN) for the autonomous system that included the IP address. |
isp | string | False | The name of the internet service provider (ISP) that owned the IP address. |
org | string | False | The name of the organization that owned the IP address. |
KeyValuePair
Provides information about the tags that are associated with an S3 bucket or object. Each tag consists of a required tag key and an associated tag value.
Property | Type | Required | Description |
---|---|---|---|
key | string | False | One part of a key-value pair that comprises a tag. A tag key is a general label that acts as a category for more specific tag values. |
value | string | False | One part of a key-value pair that comprises a tag. A tag value acts as a descriptor for a tag key. A tag value can be an empty string. |
Occurrences
Specifies the location of 1-15 occurrences of sensitive data that was detected by a managed data identifier or a custom data identifier and produced a sensitive data finding.
Property | Type | Required | Description |
---|---|---|---|
cells | Array of type Cell | False | An array of objects, one for each occurrence of sensitive data in a Microsoft Excel workbook, CSV file, or TSV file. This value is null for all other types of files. Each |
lineRanges | Array of type Range | False | An array of objects, one for each occurrence of sensitive data in an email message or a non-binary
text file such as an HTML, TXT, or XML file. Each This value is often null for file types that are supported by |
offsetRanges | Array of type Range | False | Reserved for future use. |
pages | Array of type Page | False | An array of objects, one for each occurrence of sensitive data in an Adobe Portable Document Format file. This value is null for all other types of files. Each |
records | Array of type Record | False | An array of objects, one for each occurrence of sensitive data in an Apache Avro object container, Apache Parquet file, JSON file, or JSON Lines file. This value is null for all other types of files. For an Avro object container or Parquet file, each |
OriginType
Specifies how Amazon Macie found the sensitive data that produced a finding. Possible values are:
SENSITIVE_DATA_DISCOVERY_JOB
AUTOMATED_SENSITIVE_DATA_DISCOVERY
Page
Specifies the location of an occurrence of sensitive data in an Adobe Portable Document Format file.
PolicyDetails
Provides the details of a policy finding.
Property | Type | Required | Description |
---|---|---|---|
action | False | The action that produced the finding. | |
actor | False | The entity that performed the action that produced the finding. |
Range
Specifies the location of an occurrence of sensitive data in an email message or a non-binary text file such as an HTML, TXT, or XML file.
Property | Type | Required | Description |
---|---|---|---|
end | integer Format: int64 | False | The number of lines from the beginning of the file to the end of the sensitive data. |
start | integer Format: int64 | False | The number of lines from the beginning of the file to the beginning of the sensitive data. |
startColumn | integer Format: int64 | False | The number of characters, with spaces and starting from 1, from the beginning of
the first line that contains the sensitive data ( |
Record
Specifies the location of an occurrence of sensitive data in an Apache Avro object container, Apache Parquet file, JSON file, or JSON Lines file.
Property | Type | Required | Description |
---|---|---|---|
jsonPath | string | False | The path, as a JSONPath expression, to the sensitive data. For an Avro object
container or Parquet file, this is the path to the field in the record
( If Amazon Macie detects sensitive data in the name of any element in the path, Macie omits this field. If the name of an element exceeds 240 characters, Macie truncates the name by removing characters from the beginning of the name. If the resulting full path exceeds 250 characters, Macie also truncates the path, starting with the first element in the path, until the path contains 250 or fewer characters. |
recordIndex | integer Format: int64 | False | For an Avro object container or Parquet file, the record index, starting from 0,
for the record that contains the sensitive data. For a JSON Lines file, the line
index, starting from 0, for the line that contains the sensitive data. This value is
always |
ResourceNotFoundException
Provides information about an error that occurred because a specified resource wasn't found.
Property | Type | Required | Description |
---|---|---|---|
message | string | False | The explanation of the error that occurred. |
ResourcesAffected
Provides information about the resources that a finding applies to.
S3Bucket
Provides information about the S3 bucket that a finding applies to.
Property | Type | Required | Description |
---|---|---|---|
allowsUnencryptedObjectUploads | string Values: | False | Specifies whether the bucket policy for the bucket requires server-side encryption of objects when objects are added to the bucket. Possible values are:
Valid server-side encryption headers are:
|
arn | string | False | The Amazon Resource Name (ARN) of the bucket. |
createdAt | string Format: date-time | False | The date and time, in UTC and extended ISO 8601 format, when the bucket was created. This value can also indicate when changes such as edits to the bucket's policy were most recently made to the bucket, relative to when the finding was created or last updated. |
defaultServerSideEncryption | False | The default server-side encryption settings for the bucket. | |
name | string | False | The name of the bucket. |
owner | False | The display name and canonical user ID for the AWS account that owns the bucket. | |
publicAccess | False | The permissions settings that determine whether the bucket is publicly accessible. | |
tags | Array of type KeyValuePair | False | The tags that are associated with the bucket. |
S3BucketOwner
Provides information about the AWS account that owns an S3 bucket.
Property | Type | Required | Description |
---|---|---|---|
displayName | string | False | The display name of the account that owns the bucket. |
id | string | False | The canonical user ID for the account that owns the bucket. |
S3Object
Provides information about the S3 object that a finding applies to.
Property | Type | Required | Description |
---|---|---|---|
bucketArn | string | False | The Amazon Resource Name (ARN) of the bucket that contains the object. |
eTag | string | False | The entity tag (ETag) that identifies the affected version of the object. If the object was overwritten or changed after Amazon Macie produced the finding, this value might be different from the current ETag for the object. |
extension | string | False | The file name extension of the object. If the object doesn't have a file name
extension, this value is |
key | string | False | The full name (key) of the object, including the object's prefix if applicable. |
lastModified | string Format: date-time | False | The date and time, in UTC and extended ISO 8601 format, when the object was last modified. |
path | string | False | The full path to the affected object, including the name of the affected bucket and the object's name ( |
publicAccess | boolean | False | Specifies whether the object is publicly accessible due to the combination of permissions settings that apply to the object. |
serverSideEncryption | False | The type of server-side encryption that was used to encrypt the object. | |
size | integer Format: int64 | False | The total storage size, in bytes, of the object. |
storageClass | False | The storage class of the object. | |
tags | Array of type KeyValuePair | False | The tags that are associated with the object. |
versionId | string | False | The identifier for the affected version of the object. |
SensitiveDataItem
Provides information about the category, types, and occurrences of sensitive data that produced a sensitive data finding.
Property | Type | Required | Description |
---|---|---|---|
category | False | The category of sensitive data that was detected. For example:
| |
detections | Array of type DefaultDetection | False | An array of objects, one for each type of sensitive data that was detected. Each object reports the number of occurrences of a specific type of sensitive data that was detected, and the location of up to 15 of those occurrences. |
totalCount | integer Format: int64 | False | The total number of occurrences of the sensitive data that was detected. |
SensitiveDataItemCategory
For a finding, the category of sensitive data that was detected and produced the finding. For a managed data identifier, the category of sensitive data that the managed data identifier detects. Possible values are:
FINANCIAL_INFORMATION
PERSONAL_INFORMATION
CREDENTIALS
CUSTOM_IDENTIFIER
ServerSideEncryption
Provides information about the default server-side encryption settings for an S3 bucket or the encryption settings for an S3 object.
Property | Type | Required | Description |
---|---|---|---|
encryptionType | False | The server-side encryption algorithm that's used when storing data in the bucket
or object. If default encryption settings aren't configured for the bucket or the object isn't
encrypted using server-side encryption, this value is | |
kmsMasterKeyId | string | False | The Amazon Resource Name (ARN) or unique identifier (key ID) for the AWS KMS key that's used to encrypt data in the bucket or the object. This value is null if an AWS KMS key isn't used to encrypt the data. |
ServiceQuotaExceededException
Provides information about an error that occurred due to one or more service quotas for an account.
Property | Type | Required | Description |
---|---|---|---|
message | string | False | The explanation of the error that occurred. |
SessionContext
Provides information about a session that was created for an entity that performed an action by using temporary security credentials.
Property | Type | Required | Description |
---|---|---|---|
attributes | False | The date and time when the credentials were issued, and whether the credentials were authenticated with a multi-factor authentication (MFA) device. | |
sessionIssuer | False | The source and type of credentials that were issued to the entity. |
SessionContextAttributes
Provides information about the context in which temporary security credentials were issued to an entity.
Property | Type | Required | Description |
---|---|---|---|
creationDate | string Format: date-time | False | The date and time, in UTC and ISO 8601 format, when the credentials were issued. |
mfaAuthenticated | boolean | False | Specifies whether the credentials were authenticated with a multi-factor authentication (MFA) device. |
SessionIssuer
Provides information about the source and type of temporary security credentials that were issued to an entity.
Property | Type | Required | Description |
---|---|---|---|
accountId | string | False | The unique identifier for the AWS account that owns the entity that was used to get the credentials. |
arn | string | False | The Amazon Resource Name (ARN) of the source account, AWS Identity and Access Management (IAM) user, or role that was used to get the credentials. |
principalId | string | False | The unique identifier for the entity that was used to get the credentials. |
type | string | False | The source of the temporary security credentials, such as |
userName | string | False | The name or alias of the user or role that issued the session. This value is null if the credentials were obtained from a root account that doesn't have an alias. |
Severity
Provides the numerical and qualitative representations of a finding's severity.
Property | Type | Required | Description |
---|---|---|---|
description | False | The qualitative representation of the finding's severity, ranging from
| |
score | integer Format: int64 | False | The numerical representation of the finding's severity, ranging from
|
SeverityDescription
The qualitative representation of the finding's severity. Possible values are:
Low
Medium
High
SortCriteria
Specifies criteria for sorting the results of a request for findings.
Property | Type | Required | Description |
---|---|---|---|
attributeName | string | False | The name of the property to sort the results by. Valid values are:
|
orderBy | string Values: | False | The sort order to apply to the results, based on the value for the property
specified by the |
StorageClass
The storage class of the S3 object. Possible values are:
STANDARD
REDUCED_REDUNDANCY
STANDARD_IA
INTELLIGENT_TIERING
DEEP_ARCHIVE
ONEZONE_IA
GLACIER
GLACIER_IR
OUTPOSTS
ThrottlingException
Provides information about an error that occurred because too many requests were sent during a certain amount of time.
Property | Type | Required | Description |
---|---|---|---|
message | string | False | The explanation of the error that occurred. |
UserIdentity
Provides information about the type and other characteristics of an entity that performed an action on an affected resource.
Property | Type | Required | Description |
---|---|---|---|
assumedRole | False | If the action was performed with temporary security credentials that were obtained
using the | |
awsAccount | False | If the action was performed using the credentials for another AWS account, the details of that account. | |
awsService | False | If the action was performed by an AWS account that belongs to an AWS service, the name of the service. | |
federatedUser | False | If the action was performed with temporary security credentials that were obtained
using the | |
iamUser | False | If the action was performed using the credentials for an AWS Identity and Access Management (IAM) user, the name and other details about the user. | |
root | False | If the action was performed using the credentials for your AWS account, the details of your account. | |
type | False | The type of entity that performed the action. |
UserIdentityRoot
Provides information about an AWS account and entity that performed an action on an affected resource. The action was performed using the credentials for your AWS account.
Property | Type | Required | Description |
---|---|---|---|
accountId | string | False | The unique identifier for the AWS account. |
arn | string | False | The Amazon Resource Name (ARN) of the principal that performed the action. The last section of the ARN contains the name of the user or role that performed the action. |
principalId | string | False | The unique identifier for the entity that performed the action. |
UserIdentityType
The type of entity that performed the action on the affected resource. Possible values are:
AssumedRole
IAMUser
FederatedUser
Root
AWSAccount
AWSService
ValidationException
Provides information about an error that occurred due to a syntax error in a request.
Property | Type | Required | Description |
---|---|---|---|
message | string | False | The explanation of the error that occurred. |
See also
For more information about using this API in one of the language-specific AWS SDKs and references, see the following: