Use this Terraform data source to manage a response plan in AWS Systems Manager Incident Manager.
resource "aws_ssmincidents_response_plan" "example" {
arn = "exampleARN"
}
The following arguments are required:
arn
- (Required) The Amazon Resource Name (ARN) of the response plan.This data source exports the following attributes in addition to the arguments above:
name
- The name of the response plan.tags
- The tags applied to the response plan.display_name
- The long format of the response plan name. This field can contain spaces.chat_channel
- The Chatbot chat channel used for collaboration during an incident.engagements
- The Amazon Resource Name (ARN) for the contacts and escalation plans that the response plan engages during an incident.The incident_template
configuration block exports the following attributes:
title
- The title of a generated incident.impact
- The impact value of a generated incident. The following values are supported:
1
- Severe Impact2
- High Impact3
- Medium Impact4
- Low Impact5
- No Impactdedupe_string
- A string used to stop Incident Manager from creating multiple incident records for the same incident.incident_tags
- The tags assigned to an incident template. When an incident starts, Incident Manager assigns the tags specified in the template to the incident.summary
- The summary of an incident.notification_target
- The Amazon Simple Notification Service (Amazon SNS) targets that this incident notifies when it is updated. The notification_target
configuration block supports the following argument:
sns_topic_arn
- The ARN of the Amazon SNS topic.The action
configuration block exports the following attributes:
action
- (Optional) The actions that the response plan starts at the beginning of an incident.
ssm_automation
- The Systems Manager automation document to start as the runbook at the beginning of the incident. The following values are supported:
document_name
- The automation document's name.role_arn
- The Amazon Resource Name (ARN) of the role that the automation document assumes when it runs commands.document_version
- The version of the automation document to use at runtime.target_account
- The account that runs the automation document. This can be in either the management account or an application account.parameter
- The key-value pair parameters used when the automation document runs. The following values are supported:
name
- The name of parameter.values
- The values for the associated parameter name.dynamic_parameters
- The key-value pair used to resolve dynamic parameter values when processing a Systems Manager Automation runbook.The integration
configuration block exports the following attributes:
integration
- Information about third-party services integrated into the response plan. The following values are supported:
pagerduty
- Details about the PagerDuty configuration for a response plan. The following values are supported:
name
- The name of the PagerDuty configuration.service_id
- The ID of the PagerDuty service that the response plan associates with an incident when it launches.secret_id
- The ID of the AWS Secrets Manager secret that stores your PagerDuty key — either a General Access REST API Key or User Token REST API Key — and other user credentials.