Ssm Incidents
This page documents function available when using the Ssm_Incidents
module, created with @service Ssm_Incidents
.
Index
Main.Ssm_Incidents.create_replication_set
Main.Ssm_Incidents.create_response_plan
Main.Ssm_Incidents.create_timeline_event
Main.Ssm_Incidents.delete_incident_record
Main.Ssm_Incidents.delete_replication_set
Main.Ssm_Incidents.delete_resource_policy
Main.Ssm_Incidents.delete_response_plan
Main.Ssm_Incidents.delete_timeline_event
Main.Ssm_Incidents.get_incident_record
Main.Ssm_Incidents.get_replication_set
Main.Ssm_Incidents.get_resource_policies
Main.Ssm_Incidents.get_response_plan
Main.Ssm_Incidents.get_timeline_event
Main.Ssm_Incidents.list_incident_records
Main.Ssm_Incidents.list_related_items
Main.Ssm_Incidents.list_replication_sets
Main.Ssm_Incidents.list_response_plans
Main.Ssm_Incidents.list_tags_for_resource
Main.Ssm_Incidents.list_timeline_events
Main.Ssm_Incidents.put_resource_policy
Main.Ssm_Incidents.start_incident
Main.Ssm_Incidents.tag_resource
Main.Ssm_Incidents.untag_resource
Main.Ssm_Incidents.update_deletion_protection
Main.Ssm_Incidents.update_incident_record
Main.Ssm_Incidents.update_related_items
Main.Ssm_Incidents.update_replication_set
Main.Ssm_Incidents.update_response_plan
Main.Ssm_Incidents.update_timeline_event
Documentation
Main.Ssm_Incidents.create_replication_set
— Methodcreate_replication_set(regions)
create_replication_set(regions, params::Dict{String,<:Any})
A replication set replicates and encrypts your data to the provided Regions with the provided KMS key.
Arguments
regions
: The Regions that Incident Manager replicates your data to. You can have up to three Regions in your replication set.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"clientToken"
: A token ensuring that the action is called only once with the specified details.
Main.Ssm_Incidents.create_response_plan
— Methodcreate_response_plan(incident_template, name)
create_response_plan(incident_template, name, params::Dict{String,<:Any})
Creates a response plan that automates the initial response to incidents. A response plan engages contacts, starts chat channel collaboration, and initiates runbooks at the beginning of an incident.
Arguments
incident_template
: Details used to create an incident when using this response plan.name
: The short format name of the response plan. Can't include spaces.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"actions"
: The actions that the response plan starts at the beginning of an incident."chatChannel"
: The AWS Chatbot chat channel used for collaboration during an incident."clientToken"
: A token ensuring that the action is called only once with the specified details."displayName"
: The long format of the response plan name. This field can contain spaces."engagements"
: The contacts and escalation plans that the response plan engages during an incident."tags"
: A list of tags that you are adding to the response plan.
Main.Ssm_Incidents.create_timeline_event
— Methodcreate_timeline_event(client_token, event_data, event_time, event_type, incident_record_arn)
create_timeline_event(client_token, event_data, event_time, event_type, incident_record_arn, params::Dict{String,<:Any})
Creates a custom timeline event on the incident details page of an incident record. Timeline events are automatically created by Incident Manager, marking key moment during an incident. You can create custom timeline events to mark important events that are automatically detected by Incident Manager.
Arguments
client_token
: A token ensuring that the action is called only once with the specified details.event_data
: A short description of the event.event_time
: The time that the event occurred.event_type
: The type of the event. You can create timeline events of type Custom Event.incident_record_arn
: The Amazon Resource Name (ARN) of the incident record you are adding the event to.
Main.Ssm_Incidents.delete_incident_record
— Methoddelete_incident_record(arn)
delete_incident_record(arn, params::Dict{String,<:Any})
Delete an incident record from Incident Manager.
Arguments
arn
: The Amazon Resource Name (ARN) of the incident record you are deleting.
Main.Ssm_Incidents.delete_replication_set
— Methoddelete_replication_set(arn)
delete_replication_set(arn, params::Dict{String,<:Any})
Deletes all Regions in your replication set. Deleting the replication set deletes all Incident Manager data.
Arguments
arn
: The Amazon Resource Name (ARN) of the replication set you're deleting.
Main.Ssm_Incidents.delete_resource_policy
— Methoddelete_resource_policy(policy_id, resource_arn)
delete_resource_policy(policy_id, resource_arn, params::Dict{String,<:Any})
Deletes the resource policy that AWS Resource Access Manager uses to share your Incident Manager resource.
Arguments
policy_id
: The ID of the resource policy you're deleting.resource_arn
: The Amazon Resource Name (ARN) of the resource you're deleting the policy from.
Main.Ssm_Incidents.delete_response_plan
— Methoddelete_response_plan(arn)
delete_response_plan(arn, params::Dict{String,<:Any})
Deletes the specified response plan. Deleting a response plan stops all linked CloudWatch alarms and EventBridge events from creating an incident with this response plan.
Arguments
arn
: The Amazon Resource Name (ARN) of the response plan.
Main.Ssm_Incidents.delete_timeline_event
— Methoddelete_timeline_event(event_id, incident_record_arn)
delete_timeline_event(event_id, incident_record_arn, params::Dict{String,<:Any})
Deletes a timeline event from an incident.
Arguments
event_id
: The ID of the event you are updating. You can find this by using ListTimelineEvents.incident_record_arn
: The Amazon Resource Name (ARN) of the incident that the event is part of.
Main.Ssm_Incidents.get_incident_record
— Methodget_incident_record(arn)
get_incident_record(arn, params::Dict{String,<:Any})
Returns the details of the specified incident record.
Arguments
arn
: The Amazon Resource Name (ARN) of the incident record.
Main.Ssm_Incidents.get_replication_set
— Methodget_replication_set(arn)
get_replication_set(arn, params::Dict{String,<:Any})
Retrieve your Incident Manager replication set.
Arguments
arn
: The Amazon Resource Name (ARN) of the replication set you want to retrieve.
Main.Ssm_Incidents.get_resource_policies
— Methodget_resource_policies(resource_arn)
get_resource_policies(resource_arn, params::Dict{String,<:Any})
Retrieves the resource policies attached to the specified response plan.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the response plan with the attached resource policy.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: The maximum number of resource policies to display per page of results."nextToken"
: The pagination token to continue to the next page of results.
Main.Ssm_Incidents.get_response_plan
— Methodget_response_plan(arn)
get_response_plan(arn, params::Dict{String,<:Any})
Retrieves the details of the specified response plan.
Arguments
arn
: The Amazon Resource Name (ARN) of the response plan.
Main.Ssm_Incidents.get_timeline_event
— Methodget_timeline_event(event_id, incident_record_arn)
get_timeline_event(event_id, incident_record_arn, params::Dict{String,<:Any})
Retrieves a timeline event based on its ID and incident record.
Arguments
event_id
: The ID of the event. You can get an event's ID when you create it or by using ListTimelineEvents.incident_record_arn
: The Amazon Resource Name (ARN) of the incident that the timeline event is part of.
Main.Ssm_Incidents.list_incident_records
— Methodlist_incident_records()
list_incident_records(params::Dict{String,<:Any})
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.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"filters"
: Filter the list of incident records you are searching through. You can filter on the following keys: creationTime impact status createdBy"maxResults"
: The maximum number of results per page."nextToken"
: The pagination token to continue to the next page of results.
Main.Ssm_Incidents.list_related_items
— Methodlist_related_items(incident_record_arn)
list_related_items(incident_record_arn, params::Dict{String,<:Any})
List all related items for an incident record.
Arguments
incident_record_arn
: The Amazon Resource Name (ARN) of the incident record that you are listing related items for.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: The maximum number of related items per page."nextToken"
: The pagination token to continue to the next page of results.
Main.Ssm_Incidents.list_replication_sets
— Methodlist_replication_sets()
list_replication_sets(params::Dict{String,<:Any})
Lists details about the replication set configured in your account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: The maximum number of results per page."nextToken"
: The pagination token to continue to the next page of results.
Main.Ssm_Incidents.list_response_plans
— Methodlist_response_plans()
list_response_plans(params::Dict{String,<:Any})
Lists all response plans in your account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"maxResults"
: The maximum number of response plans per page."nextToken"
: The pagination token to continue to the next page of results.
Main.Ssm_Incidents.list_tags_for_resource
— Methodlist_tags_for_resource(resource_arn)
list_tags_for_resource(resource_arn, params::Dict{String,<:Any})
Lists the tags that are attached to the specified response plan.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the response plan.
Main.Ssm_Incidents.list_timeline_events
— Methodlist_timeline_events(incident_record_arn)
list_timeline_events(incident_record_arn, params::Dict{String,<:Any})
Lists timeline events of the specified incident record.
Arguments
incident_record_arn
: The Amazon Resource Name (ARN) of the incident that the event is part of.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"filters"
: Filters the timeline events based on the provided conditional values. You can filter timeline events using the following keys: eventTime eventType"maxResults"
: The maximum number of results per page."nextToken"
: The pagination token to continue to the next page of results."sortBy"
: Sort by the specified key value pair."sortOrder"
: Sorts the order of timeline events by the value specified in the sortBy field.
Main.Ssm_Incidents.put_resource_policy
— Methodput_resource_policy(policy, resource_arn)
put_resource_policy(policy, resource_arn, params::Dict{String,<:Any})
Adds a resource policy to the specified response plan.
Arguments
policy
: Details of the resource policy.resource_arn
: The Amazon Resource Name (ARN) of the response plan you're adding the resource policy to.
Main.Ssm_Incidents.start_incident
— Methodstart_incident(response_plan_arn)
start_incident(response_plan_arn, params::Dict{String,<:Any})
Used to start an incident from CloudWatch alarms, EventBridge events, or manually.
Arguments
response_plan_arn
: The Amazon Resource Name (ARN) of the response plan that pre-defines summary, chat channels, SNS topics, runbooks, title, and impact of the incident.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"clientToken"
: A token ensuring that the action is called only once with the specified details."impact"
: Defines the impact to the customers. Providing an impact overwrites the impact provided by a response plan. Possible impacts: 1 - Critical impact, this typically relates to full application failure that impacts many to all customers. 2 - High impact, partial application failure with impact to many customers. 3 - Medium impact, the application is providing reduced service to customers. 4 - Low impact, customer might aren't impacted by the problem yet. 5 - No impact, customers aren't currently impacted but urgent action is needed to avoid impact."relatedItems"
: Add related items to the incident for other responders to use. Related items are AWS resources, external links, or files uploaded to an S3 bucket."title"
: Provide a title for the incident. Providing a title overwrites the title provided by the response plan."triggerDetails"
: Details of what created the incident record in Incident Manager.
Main.Ssm_Incidents.tag_resource
— Methodtag_resource(resource_arn, tags)
tag_resource(resource_arn, tags, params::Dict{String,<:Any})
Adds a tag to a response plan.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the response plan you're adding the tags to.tags
: A list of tags that you are adding to the response plan.
Main.Ssm_Incidents.untag_resource
— Methoduntag_resource(resource_arn, tag_keys)
untag_resource(resource_arn, tag_keys, params::Dict{String,<:Any})
Removes a tag from a resource.
Arguments
resource_arn
: The Amazon Resource Name (ARN) of the response plan you're removing a tag from.tag_keys
: The name of the tag you're removing from the response plan.
Main.Ssm_Incidents.update_deletion_protection
— Methodupdate_deletion_protection(arn, deletion_protected)
update_deletion_protection(arn, deletion_protected, params::Dict{String,<:Any})
Update deletion protection to either allow or deny deletion of the final Region in a replication set.
Arguments
arn
: The Amazon Resource Name (ARN) of the replication set you're updating.deletion_protected
: Details if deletion protection is enabled or disabled in your account.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"clientToken"
: A token ensuring that the action is called only once with the specified details.
Main.Ssm_Incidents.update_incident_record
— Methodupdate_incident_record(arn)
update_incident_record(arn, params::Dict{String,<:Any})
Update the details of an incident record. You can use this action to update an incident record from the defined chat channel. For more information about using actions in chat channels, see Interacting through chat.
Arguments
arn
: The Amazon Resource Name (ARN) of the incident record you are updating.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"chatChannel"
: The AWS Chatbot chat channel for responders to collaborate in."clientToken"
: A token ensuring that the action is called only once with the specified details."impact"
: Defines the impact to customers and applications. Providing an impact overwrites the impact provided by the response plan. Possible impacts: 1 - Critical impact, this typically relates to full application failure that impacts many to all customers. 2 - High impact, partial application failure with impact to many customers. 3 - Medium impact, the application is providing reduced service to customers. 4 - Low impact, customer might aren't impacted by the problem yet. 5 - No impact, customers aren't currently impacted but urgent action is needed to avoid impact."notificationTargets"
: The SNS targets that AWS Chatbot uses to notify the chat channel of updates to an incident. You can also make updates to the incident through the chat channel using the SNS topics. Using multiple SNS topics creates redundancy in the case that a Region is down during the incident."status"
: The status of the incident. An incident can be Open or Resolved."summary"
: The summary describes what has happened during the incident."title"
: The title of the incident is a brief and easily recognizable.
Main.Ssm_Incidents.update_related_items
— Methodupdate_related_items(incident_record_arn, related_items_update)
update_related_items(incident_record_arn, related_items_update, params::Dict{String,<:Any})
Add or remove related items from the related items tab of an incident record.
Arguments
incident_record_arn
: The Amazon Resource Name (ARN) of the incident record you are updating related items in.related_items_update
: Details about the item you are adding or deleting.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"clientToken"
: A token ensuring that the action is called only once with the specified details.
Main.Ssm_Incidents.update_replication_set
— Methodupdate_replication_set(actions, arn)
update_replication_set(actions, arn, params::Dict{String,<:Any})
Add or delete Regions from your replication set.
Arguments
actions
: An action to add or delete a Region.arn
: The Amazon Resource Name (ARN) of the replication set you're updating.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"clientToken"
: A token ensuring that the action is called only once with the specified details.
Main.Ssm_Incidents.update_response_plan
— Methodupdate_response_plan(arn)
update_response_plan(arn, params::Dict{String,<:Any})
Updates the specified response plan.
Arguments
arn
: The Amazon Resource Name (ARN) of the response plan.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"actions"
: The actions that this response plan takes at the beginning of an incident."chatChannel"
: The AWS Chatbot chat channel used for collaboration during an incident."clientToken"
: A token ensuring that the action is called only once with the specified details."displayName"
: The long format name of the response plan. Can't contain spaces."engagements"
: The contacts and escalation plans that Incident Manager engages at the start of the incident."incidentTemplateDedupeString"
: Used to create only one incident record for an incident."incidentTemplateImpact"
: Defines the impact to the customers. Providing an impact overwrites the impact provided by a response plan. Possible impacts: 5 - Severe impact 4 - High impact 3 - Medium impact 2 - Low impact 1 - No impact"incidentTemplateNotificationTargets"
: The SNS targets that AWS Chatbot uses to notify the chat channels and perform actions on the incident record."incidentTemplateSummary"
: A brief summary of the incident. This typically contains what has happened, what's currently happening, and next steps."incidentTemplateTitle"
: The short format name of the incident. Can't contain spaces.
Main.Ssm_Incidents.update_timeline_event
— Methodupdate_timeline_event(client_token, event_id, incident_record_arn)
update_timeline_event(client_token, event_id, incident_record_arn, params::Dict{String,<:Any})
Updates a timeline event. You can update events of type Custom Event.
Arguments
client_token
: A token ensuring that the action is called only once with the specified details.event_id
: The ID of the event you are updating. You can find this by using ListTimelineEvents.incident_record_arn
: The Amazon Resource Name (ARN) of the incident that the timeline event is part of.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"eventData"
: A short description of the event."eventTime"
: The time that the event occurred."eventType"
: The type of the event. You can update events of type Custom Event.