SSMIncidents.Client.
list_incident_records
(**kwargs)¶Lists all incident records in your account. Use this command to retrieve the Amazon Resource Name (ARN) of the incident record you want to update.
See also: AWS API Documentation
Request Syntax
response = client.list_incident_records(
filters=[
{
'condition': {
'after': datetime(2015, 1, 1),
'before': datetime(2015, 1, 1),
'equals': {
'integerValues': [
123,
],
'stringValues': [
'string',
]
}
},
'key': 'string'
},
],
maxResults=123,
nextToken='string'
)
Filters the list of incident records through which you are searching. You can filter on the following keys:
creationTime
impact
status
createdBy
Note the following when deciding how to use Filters:
Filter the selection by using a condition.
The condition accepts before or after a specified time, equal to a string, or equal to an integer.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set: after
, before
, equals
.
After the specified timestamp.
Before the specified timestamp
The value is equal to the provided string or integer.
Note
This is a Tagged Union structure. Only one of the following top level keys can be set: integerValues
, stringValues
.
The list of integer values that the filter matches.
The list of string values that the filter matches.
The key that you're filtering on.
dict
Response Syntax
{
'incidentRecordSummaries': [
{
'arn': 'string',
'creationTime': datetime(2015, 1, 1),
'impact': 123,
'incidentRecordSource': {
'createdBy': 'string',
'invokedBy': 'string',
'resourceArn': 'string',
'source': 'string'
},
'resolvedTime': datetime(2015, 1, 1),
'status': 'OPEN'|'RESOLVED',
'title': 'string'
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
incidentRecordSummaries (list) --
The details of each listed incident record.
(dict) --
Details describing an incident record.
arn (string) --
The Amazon Resource Name (ARN) of the incident.
creationTime (datetime) --
The time the incident was created.
impact (integer) --
Defines the impact to customers and applications.
incidentRecordSource (dict) --
What caused Incident Manager to create the incident.
createdBy (string) --
The principal that started the incident.
invokedBy (string) --
The service principal that assumed the role specified in createdBy
. If no service principal assumed the role this will be left blank.
resourceArn (string) --
The resource that caused the incident to be created.
source (string) --
The service that started the incident. This can be manually created from Incident Manager, automatically created using an Amazon CloudWatch alarm, or Amazon EventBridge event.
resolvedTime (datetime) --
The time the incident was resolved.
status (string) --
The current status of the incident.
title (string) --
The title of the incident. This value is either provided by the response plan or overwritten on creation.
nextToken (string) --
The pagination token to continue to the next page of results.
Exceptions
SSMIncidents.Client.exceptions.ThrottlingException
SSMIncidents.Client.exceptions.AccessDeniedException
SSMIncidents.Client.exceptions.ValidationException
SSMIncidents.Client.exceptions.InternalServerException