Returns history for a Security Hub finding in the last 90 days. The history includes changes made to any fields in the Amazon Web Services Security Finding Format (ASFF).
See https://www.paws-r-sdk.com/docs/securityhub_get_finding_history/ for full documentation.
securityhub_get_finding_history(
FindingIdentifier,
StartTime = NULL,
EndTime = NULL,
NextToken = NULL,
MaxResults = NULL
)
[required]
An ISO 8601-formatted timestamp that indicates the start time of the
requested finding history. A correctly formatted example is
2020-05-21T20:16:34.724Z
. The value cannot contain spaces, and date
and time should be separated by T
. For more information, see RFC 3339 section 5.6, Internet Date/Time Format.
If you provide values for both StartTime
and EndTime
, Security Hub
returns finding history for the specified time period. If you provide a
value for StartTime
but not for EndTime
, Security Hub returns
finding history from the StartTime
to the time at which the API is
called. If you provide a value for EndTime
but not for StartTime
,
Security Hub returns finding history from the
CreatedAt
timestamp of the finding to the EndTime
. If you provide neither
StartTime
nor EndTime
, Security Hub returns finding history from the
CreatedAt timestamp of the finding to the time at which the API is
called. In all of these scenarios, the response is limited to 100
results, and the maximum time period is limited to 90 days.
An ISO 8601-formatted timestamp that indicates the end time of the
requested finding history. A correctly formatted example is
2020-05-21T20:16:34.724Z
. The value cannot contain spaces, and date
and time should be separated by T
. For more information, see RFC 3339 section 5.6, Internet Date/Time Format.
If you provide values for both StartTime
and EndTime
, Security Hub
returns finding history for the specified time period. If you provide a
value for StartTime
but not for EndTime
, Security Hub returns
finding history from the StartTime
to the time at which the API is
called. If you provide a value for EndTime
but not for StartTime
,
Security Hub returns finding history from the
CreatedAt
timestamp of the finding to the EndTime
. If you provide neither
StartTime
nor EndTime
, Security Hub returns finding history from the
CreatedAt timestamp of the finding to the time at which the API is
called. In all of these scenarios, the response is limited to 100
results, and the maximum time period is limited to 90 days.
A token for pagination purposes. Provide NULL
as the initial value. In
subsequent requests, provide the token included in the response to get
up to an additional 100 results of finding history. If you don’t provide
NextToken
, Security Hub returns up to 100 results of finding history
for each request.
The maximum number of results to be returned. If you don’t provide it, Security Hub returns up to 100 results of finding history.