openapi: 3.0.0 info: version: 2018-05-10 x-release: v4 title: AWS Systems Manager Incident Manager description:
Systems Manager Incident Manager is an incident management console designed to help users mitigate and recover from incidents affecting their Amazon Web Services-hosted applications. An incident is any unplanned interruption or reduction in quality of services.
Incident Manager increases incident resolution by notifying responders of impact, highlighting relevant troubleshooting data, and providing collaboration tools to get services back up and running. To achieve the primary goal of reducing the time-to-resolution of critical incidents, Incident Manager automates response plans and enables responder team escalation.
x-logo: url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png backgroundColor: "#FFFFFF" termsOfService: https://aws.amazon.com/service-terms/ contact: name: Mike Ralphson email: mike.ralphson@gmail.com url: https://github.com/mermade/aws2openapi x-twitter: PermittedSoc license: name: Apache 2.0 License url: http://www.apache.org/licenses/ x-providerName: amazonaws.com x-serviceName: ssm-incidents x-aws-signingName: ssm-incidents x-origin: - contentType: application/json url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/ssm-incidents-2018-05-10.normal.json converter: url: https://github.com/mermade/aws2openapi version: 1.0.0 x-apisguru-driver: external x-apiClientRegistration: url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct x-apisguru-categories: - cloud x-preferred: true externalDocs: description: Amazon Web Services documentation url: https://docs.aws.amazon.com/ssm-incidents/ servers: - url: http://ssm-incidents.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The SSM Incidents multi-region endpoint - url: https://ssm-incidents.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The SSM Incidents multi-region endpoint - url: http://ssm-incidents.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The SSM Incidents endpoint for China (Beijing) and China (Ningxia) - url: https://ssm-incidents.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The SSM Incidents endpoint for China (Beijing) and China (Ningxia) x-hasEquivalentPaths: true paths: /createReplicationSet: post: operationId: CreateReplicationSet description: "A replication set replicates and encrypts your data to the provided Regions with the provided KMS key. " responses: "201": description: Success content: application/json: schema: $ref: "#/components/schemas/CreateReplicationSetOutput" "480": description: ServiceQuotaExceededException content: application/json: schema: $ref: "#/components/schemas/ServiceQuotaExceededException" "481": description: ThrottlingException content: application/json: schema: $ref: "#/components/schemas/ThrottlingException" "482": description: AccessDeniedException content: application/json: schema: $ref: "#/components/schemas/AccessDeniedException" "483": description: ValidationException content: application/json: schema: $ref: "#/components/schemas/ValidationException" "484": description: ConflictException content: application/json: schema: $ref: "#/components/schemas/ConflictException" "485": description: InternalServerException content: application/json: schema: $ref: "#/components/schemas/InternalServerException" parameters: [] requestBody: required: true content: application/json: schema: type: object required: - regions properties: clientToken: description: A token that ensures that the operation is called only once with the specified details. type: string minLength: 0 maxLength: 128 regions: description: The Regions that Incident Manager replicates your data to. You can have up to three Regions in your replication set. type: object minProperties: 1 maxProperties: 3 additionalProperties: $ref: "#/components/schemas/RegionMapInputValue" tags: description: A list of tags to add to the replication set. type: object minProperties: 1 maxProperties: 50 additionalProperties: $ref: "#/components/schemas/TagValue" summary: Amazon Incident Manager Create Replication Set x-microcks-operation: delay: 0 dispatcher: FALLBACK parameters: - $ref: "#/components/parameters/X-Amz-Content-Sha256" - $ref: "#/components/parameters/X-Amz-Date" - $ref: "#/components/parameters/X-Amz-Algorithm" - $ref: "#/components/parameters/X-Amz-Credential" - $ref: "#/components/parameters/X-Amz-Security-Token" - $ref: "#/components/parameters/X-Amz-Signature" - $ref: "#/components/parameters/X-Amz-SignedHeaders" /createResponsePlan: post: operationId: CreateResponsePlan description: 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. responses: "201": description: Success content: application/json: schema: $ref: "#/components/schemas/CreateResponsePlanOutput" "480": description: ThrottlingException content: application/json: schema: $ref: "#/components/schemas/ThrottlingException" "481": description: ResourceNotFoundException content: application/json: schema: $ref: "#/components/schemas/ResourceNotFoundException" "482": description: AccessDeniedException content: application/json: schema: $ref: "#/components/schemas/AccessDeniedException" "483": description: ValidationException content: application/json: schema: $ref: "#/components/schemas/ValidationException" "484": description: ConflictException content: application/json: schema: $ref: "#/components/schemas/ConflictException" "485": description: InternalServerException content: application/json: schema: $ref: "#/components/schemas/InternalServerException" parameters: [] requestBody: required: true content: application/json: schema: type: object required: - incidentTemplate - name properties: actions: description: The actions that the response plan starts at the beginning of an incident. type: array items: $ref: "#/components/schemas/Action" minItems: 0 maxItems: 1 chatChannel: description: The Chatbot chat channel used for collaboration during an incident. type: object properties: chatbotSns: allOf: - $ref: "#/components/schemas/ChatbotSnsConfigurationSet" - description: "The Amazon SNS targets that Chatbot uses to notify the chat channel of updates to an incident. You can also make updates to the incident through the chat channel by using the Amazon SNS topics. " empty: allOf: - $ref: "#/components/schemas/EmptyChatChannel" - description: Used to remove the chat channel from an incident record or response plan. clientToken: description: A token ensuring that the operation is called only once with the specified details. type: string minLength: 0 maxLength: 128 displayName: description: The long format of the response plan name. This field can contain spaces. type: string minLength: 0 maxLength: 200 engagements: description: The Amazon Resource Name (ARN) for the contacts and escalation plans that the response plan engages during an incident. type: array items: $ref: "#/components/schemas/SsmContactsArn" minItems: 0 maxItems: 5 incidentTemplate: description: Basic details used in creating a response plan. The response plan is then used to create an incident record. type: object properties: dedupeString: allOf: - $ref: "#/components/schemas/DedupeString" - description: "Used to stop Incident Manager from creating multiple incident records for the same incident. " impact: allOf: - $ref: "#/components/schemas/Impact" - description: "The impact of the incident on your customers and applications. " incidentTags: allOf: - $ref: "#/components/schemas/TagMap" - description: Tags to assign to the template. When theStartIncident API action is called, Incident Manager assigns the tags specified in the template to the
incident.
notificationTargets:
allOf:
- $ref: "#/components/schemas/NotificationTargetSet"
- description: The Amazon SNS targets that are notified when updates are made to an incident.
summary:
allOf:
- $ref: "#/components/schemas/IncidentSummary"
- description: The summary of the incident. The summary is a brief synopsis of what occurred, what's currently happening, and context.
title:
allOf:
- $ref: "#/components/schemas/IncidentTitle"
- description: "The title of the incident. "
integrations:
description: Information about third-party services integrated into the response plan.
type: array
items:
$ref: "#/components/schemas/Integration"
minItems: 0
maxItems: 1
name:
description: The short format name of the response plan. Can't include spaces.
type: string
pattern: ^[a-zA-Z0-9-_]*$
minLength: 1
maxLength: 200
tags:
description: A list of tags that you are adding to the response plan.
type: object
minProperties: 1
maxProperties: 50
additionalProperties:
$ref: "#/components/schemas/TagValue"
summary: Amazon Incident Manager Create Response Plan
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/createTimelineEvent:
post:
operationId: CreateTimelineEvent
description: Creates a custom timeline event on the incident details page of an incident record. Incident Manager automatically creates timeline events that mark key moments during an incident.
You can create custom timeline events to mark important events that Incident Manager can detect automatically.
responses:
"201":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/CreateTimelineEventOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: ConflictException
content:
application/json:
schema:
$ref: "#/components/schemas/ConflictException"
"485":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- eventData
- eventTime
- eventType
- incidentRecordArn
properties:
clientToken:
description: A token that ensures that a client calls the action only once with the specified details.
type: string
minLength: 0
maxLength: 128
eventData:
description: A short description of the event.
type: string
minLength: 0
maxLength: 12000
eventReferences:
description: Adds one or more references to the TimelineEvent. A reference is an Amazon Web Services resource involved or associated with the incident. To specify a
reference, enter its Amazon Resource Name (ARN). You can also specify a related item associated with a resource. For example, to specify an Amazon DynamoDB (DynamoDB) table as a
resource, use the table's ARN. You can also specify an Amazon CloudWatch metric associated with the DynamoDB table as a related item.
type: array
items:
$ref: "#/components/schemas/EventReference"
minItems: 0
maxItems: 10
eventTime:
description: The time that the event occurred.
type: string
format: date-time
eventType:
description: The type of event. You can create timeline events of type Custom Event.
type: string
minLength: 0
maxLength: 100
incidentRecordArn:
description: The Amazon Resource Name (ARN) of the incident record that the action adds the incident to.
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
summary: Amazon Incident Manager Create Timeline Event
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/deleteIncidentRecord:
post:
operationId: DeleteIncidentRecord
description: "Delete an incident record from Incident Manager. "
responses:
"204":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/DeleteIncidentRecordOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"482":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"483":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- arn
properties:
arn:
description: The Amazon Resource Name (ARN) of the incident record you are deleting.
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
summary: Amazon Incident Manager Delete Incident Record
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/deleteReplicationSet#arn:
post:
operationId: DeleteReplicationSet
description: Deletes all Regions in your replication set. Deleting the replication set deletes all Incident Manager data.
responses:
"204":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/DeleteReplicationSetOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters:
- name: arn
in: query
required: true
description: The Amazon Resource Name (ARN) of the replication set you're deleting.
schema:
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
summary: Amazon Incident Manager Delete Replication Set
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/deleteResourcePolicy:
post:
operationId: DeleteResourcePolicy
description: Deletes the resource policy that Resource Access Manager uses to share your Incident Manager resource.
responses:
"200":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/DeleteResourcePolicyOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- policyId
- resourceArn
properties:
policyId:
description: The ID of the resource policy you're deleting.
type: string
minLength: 0
maxLength: 256
resourceArn:
description: The Amazon Resource Name (ARN) of the resource you're deleting the policy from.
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
summary: Amazon Incident Manager Delete Resource Policy
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/deleteResponsePlan:
post:
operationId: DeleteResponsePlan
description: 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.
responses:
"204":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/DeleteResponsePlanOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"482":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"483":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- arn
properties:
arn:
description: The Amazon Resource Name (ARN) of the response plan.
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
summary: Amazon Incident Manager Delete Response Plan
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/deleteTimelineEvent:
post:
operationId: DeleteTimelineEvent
description: Deletes a timeline event from an incident.
responses:
"204":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/DeleteTimelineEventOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"482":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"483":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- eventId
- incidentRecordArn
properties:
eventId:
description: The ID of the event to update. You can use ListTimelineEvents to find an event's ID.
type: string
minLength: 0
maxLength: 50
incidentRecordArn:
description: The Amazon Resource Name (ARN) of the incident that includes the timeline event.
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
summary: Amazon Incident Manager Delete Timeline Event
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/getIncidentRecord#arn:
get:
operationId: GetIncidentRecord
description: Returns the details for the specified incident record.
responses:
"200":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/GetIncidentRecordOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters:
- name: arn
in: query
required: true
description: The Amazon Resource Name (ARN) of the incident record.
schema:
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
summary: Amazon Incident Manager Get Incident Record
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/getReplicationSet#arn:
get:
operationId: GetReplicationSet
description: Retrieve your Incident Manager replication set.
responses:
"200":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/GetReplicationSetOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters:
- name: arn
in: query
required: true
description: The Amazon Resource Name (ARN) of the replication set you want to retrieve.
schema:
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
summary: Amazon Incident Manager Get Replication Set
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/getResourcePolicies#resourceArn:
post:
operationId: GetResourcePolicies
description: Retrieves the resource policies attached to the specified response plan.
responses:
"200":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/GetResourcePoliciesOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters:
- name: resourceArn
in: query
required: true
description: "The Amazon Resource Name (ARN) of the response plan with the attached resource policy. "
schema:
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
- name: maxResults
in: query
schema:
type: string
description: Pagination limit
required: false
- name: nextToken
in: query
schema:
type: string
description: Pagination token
required: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
maxResults:
description: The maximum number of resource policies to display for each page of results.
type: integer
minimum: 1
maximum: 100
nextToken:
description: The pagination token to continue to the next page of results.
type: string
minLength: 0
maxLength: 2000
summary: Amazon Incident Manager Get Resource Policies
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/getResponsePlan#arn:
get:
operationId: GetResponsePlan
description: Retrieves the details of the specified response plan.
responses:
"200":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/GetResponsePlanOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters:
- name: arn
in: query
required: true
description: The Amazon Resource Name (ARN) of the response plan.
schema:
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
summary: Amazon Incident Manager Get Response Plan
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/getTimelineEvent#eventId&incidentRecordArn:
get:
operationId: GetTimelineEvent
description: Retrieves a timeline event based on its ID and incident record.
responses:
"200":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/GetTimelineEventOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters:
- name: eventId
in: query
required: true
description: The ID of the event. You can get an event's ID when you create it, or by using ListTimelineEvents.
schema:
type: string
minLength: 0
maxLength: 50
- name: incidentRecordArn
in: query
required: true
description: The Amazon Resource Name (ARN) of the incident that includes the timeline event.
schema:
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
summary: Amazon Incident Manager Get Timeline Event
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/listIncidentRecords:
post:
operationId: ListIncidentRecords
description: "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. "
responses:
"200":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/ListIncidentRecordsOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"482":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"483":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters:
- name: maxResults
in: query
schema:
type: string
description: Pagination limit
required: false
- name: nextToken
in: query
schema:
type: string
description: Pagination token
required: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
filters:
description: Filters the list of incident records you want to search through. You can filter on the following keys:
creationTime
impact
status
createdBy
Note the following when when you use Filters:
If you don't specify a Filter, the response includes all incident records.
If you specify more than one filter in a single request, the response returns incident records that match all filters.
If you specify a filter with more than one value, the response returns incident records that match any of the values provided.
Filters the timeline events based on the provided conditional values. You can filter timeline events with the following keys:
eventTime
eventType
Note the following when deciding how to use Filters:
If you don't specify a Filter, the response includes all timeline events.
If you specify more than one filter in a single request, the response returns timeline events that match all filters.
If you specify a filter with more than one value, the response returns timeline events that match any of the values provided.
sortBy field.
type: string
enum:
- ASCENDING
- DESCENDING
summary: Amazon Incident Manager List Timeline Events
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/putResourcePolicy:
post:
operationId: PutResourcePolicy
description: Adds a resource policy to the specified response plan. The resource policy is used to share the response plan using Resource Access Manager (RAM). For more information about
cross-account sharing, see Cross-Region and cross-account incident
management.
responses:
"200":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/PutResourcePolicyOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- policy
- resourceArn
properties:
policy:
description: Details of the resource policy.
type: string
minLength: 0
maxLength: 4000
resourceArn:
description: The Amazon Resource Name (ARN) of the response plan to add the resource policy to.
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
summary: Amazon Incident Manager Put Resource Policy
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/startIncident:
post:
operationId: StartIncident
description: "Used to start an incident from CloudWatch alarms, EventBridge events, or manually. "
responses:
"200":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/StartIncidentOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: ConflictException
content:
application/json:
schema:
$ref: "#/components/schemas/ConflictException"
"485":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- responsePlanArn
properties:
clientToken:
description: A token ensuring that the operation is called only once with the specified details.
type: string
minLength: 0
maxLength: 128
impact:
description: 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.
aws.\" Customer-generated events can have
any value here, as long as it doesn't begin with \"aws.\" We recommend the use of Java package-name style reverse domain-name strings. "
timestamp:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The time that the incident was detected.
triggerArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the source that detected the incident.
summary: Amazon Incident Manager Start Incident
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
"/tags/{resourceArn}#tagKeys":
delete:
operationId: UntagResource
description: Removes a tag from a resource.
responses:
"204":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/UntagResourceResponse"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: ConflictException
content:
application/json:
schema:
$ref: "#/components/schemas/ConflictException"
"485":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters:
- name: resourceArn
in: path
required: true
description: The Amazon Resource Name (ARN) of the response plan you're removing a tag from.
schema:
type: string
- name: tagKeys
in: query
required: true
description: The name of the tag to remove from the response plan.
schema:
type: array
items:
$ref: "#/components/schemas/TagKey"
minItems: 1
maxItems: 50
summary: Amazon Incident Manager Untag Resource
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/updateDeletionProtection:
post:
operationId: UpdateDeletionProtection
description: Update deletion protection to either allow or deny deletion of the final Region in a replication set.
responses:
"204":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/UpdateDeletionProtectionOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- arn
- deletionProtected
properties:
arn:
description: The Amazon Resource Name (ARN) of the replication set to update.
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
clientToken:
description: A token that ensures that the operation is called only once with the specified details.
type: string
minLength: 0
maxLength: 128
deletionProtected:
description: "Specifies if deletion protection is turned on or off in your account. "
type: boolean
summary: Amazon Incident Manager Update Deletion Protection
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/updateIncidentRecord:
post:
operationId: UpdateIncidentRecord
description: Update the details of an incident record. You can use this operation to update an incident record from the defined chat channel. For more information about using actions in chat
channels, see Interacting through chat.
responses:
"204":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/UpdateIncidentRecordOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: ConflictException
content:
application/json:
schema:
$ref: "#/components/schemas/ConflictException"
"485":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- arn
properties:
arn:
description: The Amazon Resource Name (ARN) of the incident record you are updating.
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
chatChannel:
description: The Chatbot chat channel used for collaboration during an incident.
type: object
properties:
chatbotSns:
allOf:
- $ref: "#/components/schemas/ChatbotSnsConfigurationSet"
- description: "The Amazon SNS targets that Chatbot uses to notify the chat channel of updates to an incident. You can also make updates to the incident through the chat channel by
using the Amazon SNS topics. "
empty:
allOf:
- $ref: "#/components/schemas/EmptyChatChannel"
- description: Used to remove the chat channel from an incident record or response plan.
clientToken:
description: A token that ensures that a client calls the operation only once with the specified details.
type: string
minLength: 0
maxLength: 128
impact:
description: Defines the impact of the incident to customers and applications. If you provide an impact for an incident, it overwrites the impact provided by the response plan.
Possible impacts:
1 - Critical impact, 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 aren't impacted by the problem yet.
5 - No impact, customers
aren't currently impacted but urgent action is needed to avoid impact.
The Amazon SNS targets that Incident Manager notifies when a client updates an incident.
Using multiple SNS topics creates redundancy in the event that a Region is down during the incident.
type: array items: $ref: "#/components/schemas/NotificationTargetItem" minItems: 0 maxItems: 10 status: description: The status of the incident. Possible statuses areOpen or Resolved.
type: string
enum:
- OPEN
- RESOLVED
summary:
description: A longer description of what occurred during the incident.
type: string
minLength: 0
maxLength: 8000
title:
description: A brief description of the incident.
type: string
minLength: 0
maxLength: 200
summary: Amazon Incident Manager Update Incident Record
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/updateRelatedItems:
post:
operationId: UpdateRelatedItems
description: Add or remove related items from the related items tab of an incident record.
responses:
"204":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/UpdateRelatedItemsOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: ConflictException
content:
application/json:
schema:
$ref: "#/components/schemas/ConflictException"
"485":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- incidentRecordArn
- relatedItemsUpdate
properties:
clientToken:
description: A token that ensures that a client calls the operation only once with the specified details.
type: string
minLength: 0
maxLength: 128
incidentRecordArn:
description: The Amazon Resource Name (ARN) of the incident record that contains the related items that you update.
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
relatedItemsUpdate:
description: Details about the related item you're adding.
type: object
properties:
itemToAdd:
allOf:
- $ref: "#/components/schemas/RelatedItem"
- description: Details about the related item you're adding.
itemToRemove:
allOf:
- $ref: "#/components/schemas/ItemIdentifier"
- description: Details about the related item you're deleting.
summary: Amazon Incident Manager Update Related Items
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/updateReplicationSet:
post:
operationId: UpdateReplicationSet
description: Add or delete Regions from your replication set.
responses:
"204":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/UpdateReplicationSetOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: ConflictException
content:
application/json:
schema:
$ref: "#/components/schemas/ConflictException"
"485":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- actions
- arn
properties:
actions:
description: An action to add or delete a Region.
type: array
items:
$ref: "#/components/schemas/UpdateReplicationSetAction"
minItems: 1
maxItems: 1
arn:
description: The Amazon Resource Name (ARN) of the replication set you're updating.
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
clientToken:
description: A token that ensures that the operation is called only once with the specified details.
type: string
minLength: 0
maxLength: 128
summary: Amazon Incident Manager Update Replication Set
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/updateResponsePlan:
post:
operationId: UpdateResponsePlan
description: Updates the specified response plan.
responses:
"204":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/UpdateResponsePlanOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: ConflictException
content:
application/json:
schema:
$ref: "#/components/schemas/ConflictException"
"485":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- arn
properties:
actions:
description: The actions that this response plan takes at the beginning of an incident.
type: array
items:
$ref: "#/components/schemas/Action"
minItems: 0
maxItems: 1
arn:
description: The Amazon Resource Name (ARN) of the response plan.
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
chatChannel:
description: The Chatbot chat channel used for collaboration during an incident.
type: object
properties:
chatbotSns:
allOf:
- $ref: "#/components/schemas/ChatbotSnsConfigurationSet"
- description: "The Amazon SNS targets that Chatbot uses to notify the chat channel of updates to an incident. You can also make updates to the incident through the chat channel by
using the Amazon SNS topics. "
empty:
allOf:
- $ref: "#/components/schemas/EmptyChatChannel"
- description: Used to remove the chat channel from an incident record or response plan.
clientToken:
description: A token ensuring that the operation is called only once with the specified details.
type: string
minLength: 0
maxLength: 128
displayName:
description: The long format name of the response plan. The display name can't contain spaces.
type: string
minLength: 0
maxLength: 200
engagements:
description: The Amazon Resource Name (ARN) for the contacts and escalation plans that the response plan engages during an incident.
type: array
items:
$ref: "#/components/schemas/SsmContactsArn"
minItems: 0
maxItems: 5
incidentTemplateDedupeString:
description: The string Incident Manager uses to prevent duplicate incidents from being created by the same incident in the same account.
type: string
minLength: 0
maxLength: 1000
incidentTemplateImpact:
description: 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
StartIncident API action is called, Incident Manager assigns the tags specified in the template to the incident. To
call this action, you must also have permission to call the TagResource API action for the incident record resource.
type: object
minProperties: 0
maxProperties: 50
additionalProperties:
$ref: "#/components/schemas/TagValue"
incidentTemplateTitle:
description: The short format name of the incident. The title can't contain spaces.
type: string
minLength: 0
maxLength: 200
integrations:
description: Information about third-party services integrated into the response plan.
type: array
items:
$ref: "#/components/schemas/Integration"
minItems: 0
maxItems: 1
summary: Amazon Incident Manager Update Response Plan
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
/updateTimelineEvent:
post:
operationId: UpdateTimelineEvent
description: Updates a timeline event. You can update events of type Custom Event.
responses:
"204":
description: Success
content:
application/json:
schema:
$ref: "#/components/schemas/UpdateTimelineEventOutput"
"480":
description: ThrottlingException
content:
application/json:
schema:
$ref: "#/components/schemas/ThrottlingException"
"481":
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: "#/components/schemas/ResourceNotFoundException"
"482":
description: AccessDeniedException
content:
application/json:
schema:
$ref: "#/components/schemas/AccessDeniedException"
"483":
description: ValidationException
content:
application/json:
schema:
$ref: "#/components/schemas/ValidationException"
"484":
description: ConflictException
content:
application/json:
schema:
$ref: "#/components/schemas/ConflictException"
"485":
description: InternalServerException
content:
application/json:
schema:
$ref: "#/components/schemas/InternalServerException"
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- eventId
- incidentRecordArn
properties:
clientToken:
description: A token that ensures that a client calls the operation only once with the specified details.
type: string
minLength: 0
maxLength: 128
eventData:
description: A short description of the event.
type: string
minLength: 0
maxLength: 12000
eventId:
description: The ID of the event to update. You can use ListTimelineEvents to find an event's ID.
type: string
minLength: 0
maxLength: 50
eventReferences:
description: Updates all existing references in a TimelineEvent. A reference is an Amazon Web Services resource involved or associated with the incident. To specify a
reference, enter its Amazon Resource Name (ARN). You can also specify a related item associated with that resource. For example, to specify an Amazon DynamoDB (DynamoDB) table as a
resource, use its ARN. You can also specify an Amazon CloudWatch metric associated with the DynamoDB table as a related item.
This update action overrides all existing references. If you want to keep existing references, you must specify them in the call. If you don't, this action removes any existing references and enters only new references.
Custom Event.
type: string
minLength: 0
maxLength: 100
incidentRecordArn:
description: The Amazon Resource Name (ARN) of the incident that includes the timeline event.
type: string
pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
minLength: 0
maxLength: 1000
summary: Amazon Incident Manager Update Timeline Event
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
parameters:
- $ref: "#/components/parameters/X-Amz-Content-Sha256"
- $ref: "#/components/parameters/X-Amz-Date"
- $ref: "#/components/parameters/X-Amz-Algorithm"
- $ref: "#/components/parameters/X-Amz-Credential"
- $ref: "#/components/parameters/X-Amz-Security-Token"
- $ref: "#/components/parameters/X-Amz-Signature"
- $ref: "#/components/parameters/X-Amz-SignedHeaders"
components:
parameters:
X-Amz-Content-Sha256:
name: X-Amz-Content-Sha256
in: header
schema:
type: string
required: false
X-Amz-Date:
name: X-Amz-Date
in: header
schema:
type: string
required: false
X-Amz-Algorithm:
name: X-Amz-Algorithm
in: header
schema:
type: string
required: false
X-Amz-Credential:
name: X-Amz-Credential
in: header
schema:
type: string
required: false
X-Amz-Security-Token:
name: X-Amz-Security-Token
in: header
schema:
type: string
required: false
X-Amz-Signature:
name: X-Amz-Signature
in: header
schema:
type: string
required: false
X-Amz-SignedHeaders:
name: X-Amz-SignedHeaders
in: header
schema:
type: string
required: false
securitySchemes:
hmac:
type: apiKey
name: Authorization
in: header
description: Amazon Signature authorization v4
x-amazon-apigateway-authtype: awsSigv4
schemas:
CreateReplicationSetOutput:
type: object
required:
- arn
properties:
arn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: "The Amazon Resource Name (ARN) of the replication set. "
RegionMapInputValue:
type: object
properties:
sseKmsKeyId:
allOf:
- $ref: "#/components/schemas/SseKmsKey"
- description: The KMS key used to encrypt the data in your replication set.
description: The mapping between a Amazon Web Services Region and the key that's used to encrypt the data.
TagValue:
type: string
pattern: ^[A-Za-z0-9 _=@:.+-/]*$
minLength: 0
maxLength: 256
ServiceQuotaExceededException: {}
ThrottlingException: {}
AccessDeniedException: {}
ValidationException: {}
ConflictException: {}
InternalServerException: {}
CreateResponsePlanOutput:
type: object
required:
- arn
properties:
arn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the response plan.
Action:
type: object
properties:
ssmAutomation:
allOf:
- $ref: "#/components/schemas/SsmAutomation"
- description: The Systems Manager automation document to start as the runbook at the beginning of the incident.
description: The action that starts at the beginning of an incident. The response plan defines the action.
ChatbotSnsConfigurationSet:
type: array
items:
$ref: "#/components/schemas/SnsArn"
minItems: 1
maxItems: 5
EmptyChatChannel:
type: object
properties: {}
description: Used to remove the chat channel from an incident record or response plan.
SsmContactsArn:
type: string
pattern: ^arn:aws(-cn|-us-gov)?:ssm-contacts:[a-z0-9-]*:([0-9]{12}):contact/[a-z0-9_-]+$
minLength: 0
maxLength: 2048
DedupeString:
type: string
minLength: 0
maxLength: 1000
Impact:
type: integer
minimum: 1
maximum: 5
TagMap:
type: object
minProperties: 1
maxProperties: 50
additionalProperties:
$ref: "#/components/schemas/TagValue"
NotificationTargetSet:
type: array
items:
$ref: "#/components/schemas/NotificationTargetItem"
minItems: 0
maxItems: 10
IncidentSummary:
type: string
minLength: 0
maxLength: 8000
IncidentTitle:
type: string
minLength: 0
maxLength: 200
Integration:
type: object
properties:
pagerDutyConfiguration:
allOf:
- $ref: "#/components/schemas/PagerDutyConfiguration"
- description: Information about the PagerDuty service where the response plan creates an incident.
description: Information about third-party services integrated into a response plan.
ResourceNotFoundException: {}
CreateTimelineEventOutput:
type: object
required:
- eventId
- incidentRecordArn
properties:
eventId:
allOf:
- $ref: "#/components/schemas/UUID"
- description: "The ID of the event for easy reference later. "
incidentRecordArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The ARN of the incident record that you added the event to.
EventReference:
type: object
properties:
relatedItemId:
allOf:
- $ref: "#/components/schemas/GeneratedId"
- description: The ID of a RelatedItem referenced in a TimelineEvent.
resource:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of an Amazon Web Services resource referenced in a TimelineEvent.
description: An item referenced in a TimelineEvent that is involved in or somehow associated with an incident. You can specify an Amazon Resource Name (ARN) for an Amazon Web
Services resource or a RelatedItem ID.
DeleteIncidentRecordOutput:
type: object
properties: {}
DeleteReplicationSetOutput:
type: object
properties: {}
DeleteResourcePolicyOutput:
type: object
properties: {}
DeleteResponsePlanOutput:
type: object
properties: {}
DeleteTimelineEventOutput:
type: object
properties: {}
GetIncidentRecordOutput:
type: object
required:
- incidentRecord
properties:
incidentRecord:
allOf:
- $ref: "#/components/schemas/IncidentRecord"
- description: Details the structure of the incident record.
GetReplicationSetOutput:
type: object
required:
- replicationSet
properties:
replicationSet:
allOf:
- $ref: "#/components/schemas/ReplicationSet"
- description: Details of the replication set.
GetResourcePoliciesOutput:
type: object
required:
- resourcePolicies
properties:
nextToken:
allOf:
- $ref: "#/components/schemas/NextToken"
- description: The pagination token to continue to the next page of results.
resourcePolicies:
allOf:
- $ref: "#/components/schemas/ResourcePolicyList"
- description: Details about the resource policy attached to the response plan.
GetResponsePlanOutput:
type: object
required:
- arn
- incidentTemplate
- name
properties:
actions:
allOf:
- $ref: "#/components/schemas/ActionsList"
- description: The actions that this response plan takes at the beginning of the incident.
arn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The ARN of the response plan.
chatChannel:
allOf:
- $ref: "#/components/schemas/ChatChannel"
- description: The Chatbot chat channel used for collaboration during an incident.
displayName:
allOf:
- $ref: "#/components/schemas/ResponsePlanDisplayName"
- description: The long format name of the response plan. Can contain spaces.
engagements:
allOf:
- $ref: "#/components/schemas/EngagementSet"
- description: The Amazon Resource Name (ARN) for the contacts and escalation plans that the response plan engages during an incident.
incidentTemplate:
allOf:
- $ref: "#/components/schemas/IncidentTemplate"
- description: Details used to create the incident when using this response plan.
integrations:
allOf:
- $ref: "#/components/schemas/Integrations"
- description: Information about third-party services integrated into the Incident Manager response plan.
name:
allOf:
- $ref: "#/components/schemas/ResponsePlanName"
- description: The short format name of the response plan. The name can't contain spaces.
GetTimelineEventOutput:
type: object
required:
- event
properties:
event:
allOf:
- $ref: "#/components/schemas/TimelineEvent"
- description: Details about the timeline event.
ListIncidentRecordsOutput:
type: object
required:
- incidentRecordSummaries
properties:
incidentRecordSummaries:
allOf:
- $ref: "#/components/schemas/IncidentRecordSummaryList"
- description: The details of each listed incident record.
nextToken:
allOf:
- $ref: "#/components/schemas/NextToken"
- description: The pagination token to continue to the next page of results.
Filter:
type: object
required:
- condition
- key
properties:
condition:
allOf:
- $ref: "#/components/schemas/Condition"
- description: The condition accepts before or after a specified time, equal to a string, or equal to an integer.
key:
allOf:
- $ref: "#/components/schemas/FilterKeyString"
- description: The key that you're filtering on.
description: Filter the selection by using a condition.
ListRelatedItemsOutput:
type: object
required:
- relatedItems
properties:
nextToken:
allOf:
- $ref: "#/components/schemas/NextToken"
- description: The pagination token to continue to the next page of results.
relatedItems:
allOf:
- $ref: "#/components/schemas/RelatedItemList"
- description: Details about each related item.
ListReplicationSetsOutput:
type: object
required:
- replicationSetArns
properties:
nextToken:
allOf:
- $ref: "#/components/schemas/NextToken"
- description: The pagination token to continue to the next page of results.
replicationSetArns:
allOf:
- $ref: "#/components/schemas/ReplicationSetArnList"
- description: The Amazon Resource Name (ARN) of the list replication set.
ListResponsePlansOutput:
type: object
required:
- responsePlanSummaries
properties:
nextToken:
allOf:
- $ref: "#/components/schemas/NextToken"
- description: The pagination token to continue to the next page of results.
responsePlanSummaries:
allOf:
- $ref: "#/components/schemas/ResponsePlanSummaryList"
- description: Details of each response plan.
ListTagsForResourceResponse:
type: object
required:
- tags
properties:
tags:
allOf:
- $ref: "#/components/schemas/TagMap"
- description: A list of tags for the response plan.
ListTimelineEventsOutput:
type: object
required:
- eventSummaries
properties:
eventSummaries:
allOf:
- $ref: "#/components/schemas/EventSummaryList"
- description: Details about each event that occurred during the incident.
nextToken:
allOf:
- $ref: "#/components/schemas/NextToken"
- description: The pagination token to continue to the next page of results.
PutResourcePolicyOutput:
type: object
required:
- policyId
properties:
policyId:
allOf:
- $ref: "#/components/schemas/PolicyId"
- description: The ID of the resource policy.
StartIncidentOutput:
type: object
required:
- incidentRecordArn
properties:
incidentRecordArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The ARN of the newly created incident record.
RelatedItem:
type: object
required:
- identifier
properties:
generatedId:
allOf:
- $ref: "#/components/schemas/GeneratedId"
- description: A unique ID for a RelatedItem.
Don't specify this parameter when you add a RelatedItem by using the UpdateRelatedItems
API action.
ANDed statement. If multiple values are specified for a conditional, the values are ORd.
RegionMapInput:
type: object
minProperties: 1
maxProperties: 3
additionalProperties:
$ref: "#/components/schemas/RegionMapInputValue"
CreateReplicationSetInput:
type: object
required:
- regions
title: CreateReplicationSetInput
properties:
clientToken:
allOf:
- $ref: "#/components/schemas/ClientToken"
- description: A token that ensures that the operation is called only once with the specified details.
regions:
allOf:
- $ref: "#/components/schemas/RegionMapInput"
- description: The Regions that Incident Manager replicates your data to. You can have up to three Regions in your replication set.
tags:
allOf:
- $ref: "#/components/schemas/TagMap"
- description: A list of tags to add to the replication set.
ResponsePlanDisplayName:
type: string
minLength: 0
maxLength: 200
EngagementSet:
type: array
items:
$ref: "#/components/schemas/SsmContactsArn"
minItems: 0
maxItems: 5
IncidentTemplate:
type: object
required:
- impact
- title
properties:
dedupeString:
allOf:
- $ref: "#/components/schemas/DedupeString"
- description: "Used to stop Incident Manager from creating multiple incident records for the same incident. "
impact:
allOf:
- $ref: "#/components/schemas/Impact"
- description: "The impact of the incident on your customers and applications. "
incidentTags:
allOf:
- $ref: "#/components/schemas/TagMap"
- description: Tags to assign to the template. When the StartIncident API action is called, Incident Manager assigns the tags specified in the template to the incident.
notificationTargets:
allOf:
- $ref: "#/components/schemas/NotificationTargetSet"
- description: The Amazon SNS targets that are notified when updates are made to an incident.
summary:
allOf:
- $ref: "#/components/schemas/IncidentSummary"
- description: The summary of the incident. The summary is a brief synopsis of what occurred, what's currently happening, and context.
title:
allOf:
- $ref: "#/components/schemas/IncidentTitle"
- description: "The title of the incident. "
description: Basic details used in creating a response plan. The response plan is then used to create an incident record.
Integrations:
type: array
items:
$ref: "#/components/schemas/Integration"
minItems: 0
maxItems: 1
ResponsePlanName:
type: string
pattern: ^[a-zA-Z0-9-_]*$
minLength: 1
maxLength: 200
CreateResponsePlanInput:
type: object
required:
- incidentTemplate
- name
title: CreateResponsePlanInput
properties:
actions:
allOf:
- $ref: "#/components/schemas/ActionsList"
- description: The actions that the response plan starts at the beginning of an incident.
chatChannel:
allOf:
- $ref: "#/components/schemas/ChatChannel"
- description: The Chatbot chat channel used for collaboration during an incident.
clientToken:
allOf:
- $ref: "#/components/schemas/ClientToken"
- description: A token ensuring that the operation is called only once with the specified details.
displayName:
allOf:
- $ref: "#/components/schemas/ResponsePlanDisplayName"
- description: The long format of the response plan name. This field can contain spaces.
engagements:
allOf:
- $ref: "#/components/schemas/EngagementSet"
- description: The Amazon Resource Name (ARN) for the contacts and escalation plans that the response plan engages during an incident.
incidentTemplate:
allOf:
- $ref: "#/components/schemas/IncidentTemplate"
- description: Details used to create an incident when using this response plan.
integrations:
allOf:
- $ref: "#/components/schemas/Integrations"
- description: Information about third-party services integrated into the response plan.
name:
allOf:
- $ref: "#/components/schemas/ResponsePlanName"
- description: The short format name of the response plan. Can't include spaces.
tags:
allOf:
- $ref: "#/components/schemas/TagMap"
- description: A list of tags that you are adding to the response plan.
EventData:
type: string
minLength: 0
maxLength: 12000
EventReferenceList:
type: array
items:
$ref: "#/components/schemas/EventReference"
minItems: 0
maxItems: 10
TimelineEventType:
type: string
minLength: 0
maxLength: 100
CreateTimelineEventInput:
type: object
required:
- eventData
- eventTime
- eventType
- incidentRecordArn
title: CreateTimelineEventInput
properties:
clientToken:
allOf:
- $ref: "#/components/schemas/ClientToken"
- description: A token that ensures that a client calls the action only once with the specified details.
eventData:
allOf:
- $ref: "#/components/schemas/EventData"
- description: A short description of the event.
eventReferences:
allOf:
- $ref: "#/components/schemas/EventReferenceList"
- description: Adds one or more references to the TimelineEvent. A reference is an Amazon Web Services resource involved or associated with the incident. To specify a reference,
enter its Amazon Resource Name (ARN). You can also specify a related item associated with a resource. For example, to specify an Amazon DynamoDB (DynamoDB) table as a resource, use the
table's ARN. You can also specify an Amazon CloudWatch metric associated with the DynamoDB table as a related item.
eventTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The time that the event occurred.
eventType:
allOf:
- $ref: "#/components/schemas/TimelineEventType"
- description: The type of event. You can create timeline events of type Custom Event.
incidentRecordArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the incident record that the action adds the incident to.
UUID:
type: string
minLength: 0
maxLength: 50
DeleteIncidentRecordInput:
type: object
required:
- arn
title: DeleteIncidentRecordInput
properties:
arn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the incident record you are deleting.
DeleteRegionAction:
type: object
required:
- regionName
properties:
regionName:
allOf:
- $ref: "#/components/schemas/RegionName"
- description: The name of the Amazon Web Services Region you're deleting from the replication set.
description: Defines the information about the Amazon Web Services Region you're deleting from your replication set.
DeleteReplicationSetInput:
type: object
title: DeleteReplicationSetInput
properties: {}
PolicyId:
type: string
minLength: 0
maxLength: 256
DeleteResourcePolicyInput:
type: object
required:
- policyId
- resourceArn
title: DeleteResourcePolicyInput
properties:
policyId:
allOf:
- $ref: "#/components/schemas/PolicyId"
- description: The ID of the resource policy you're deleting.
resourceArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the resource you're deleting the policy from.
DeleteResponsePlanInput:
type: object
required:
- arn
title: DeleteResponsePlanInput
properties:
arn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the response plan.
DeleteTimelineEventInput:
type: object
required:
- eventId
- incidentRecordArn
title: DeleteTimelineEventInput
properties:
eventId:
allOf:
- $ref: "#/components/schemas/UUID"
- description: The ID of the event to update. You can use ListTimelineEvents to find an event's ID.
incidentRecordArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the incident that includes the timeline event.
VariableType:
type: string
enum:
- INCIDENT_RECORD_ARN
- INVOLVED_RESOURCES
DynamicSsmParameterValue:
type: object
properties:
variable:
allOf:
- $ref: "#/components/schemas/VariableType"
- description: Variable dynamic parameters. A parameter value is determined when an incident is created.
description: The dynamic SSM parameter value.
DynamicSsmParameters:
type: object
minProperties: 1
maxProperties: 200
additionalProperties:
$ref: "#/components/schemas/DynamicSsmParameterValue"
DynamicSsmParametersKeyString:
type: string
minLength: 1
maxLength: 50
GeneratedId:
type: string
pattern: ^related-item/(ANALYSIS|INCIDENT|METRIC|PARENT|ATTACHMENT|OTHER|AUTOMATION|INVOLVED_RESOURCE|TASK)/([0-9]|[A-F]){32}$
minLength: 0
maxLength: 200
EventSummary:
type: object
required:
- eventId
- eventTime
- eventType
- eventUpdatedTime
- incidentRecordArn
properties:
eventId:
allOf:
- $ref: "#/components/schemas/UUID"
- description: The timeline event ID.
eventReferences:
allOf:
- $ref: "#/components/schemas/EventReferenceList"
- description: A list of references in a TimelineEvent.
eventTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The time that the event occurred.
eventType:
allOf:
- $ref: "#/components/schemas/TimelineEventType"
- description: The type of event. The timeline event must be Custom Event.
eventUpdatedTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The time that the timeline event was last updated.
incidentRecordArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the incident that the event happened during.
description: Details about a timeline event during an incident.
EventSummaryList:
type: array
items:
$ref: "#/components/schemas/EventSummary"
minItems: 0
maxItems: 100
FilterKeyString:
type: string
minLength: 0
maxLength: 50
FilterList:
type: array
items:
$ref: "#/components/schemas/Filter"
minItems: 0
maxItems: 5
GetIncidentRecordInput:
type: object
title: GetIncidentRecordInput
properties: {}
IncidentRecord:
type: object
required:
- arn
- creationTime
- dedupeString
- impact
- incidentRecordSource
- lastModifiedBy
- lastModifiedTime
- status
- title
properties:
arn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the incident record.
automationExecutions:
allOf:
- $ref: "#/components/schemas/AutomationExecutionSet"
- description: The runbook, or automation document, that's run at the beginning of the incident.
chatChannel:
allOf:
- $ref: "#/components/schemas/ChatChannel"
- description: The chat channel used for collaboration during an incident.
creationTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The time that Incident Manager created the incident record.
dedupeString:
allOf:
- $ref: "#/components/schemas/DedupeString"
- description: The string Incident Manager uses to prevent duplicate incidents from being created by the same incident in the same account.
impact:
allOf:
- $ref: "#/components/schemas/Impact"
- description: The impact of the incident on customers and applications.
incidentRecordSource:
allOf:
- $ref: "#/components/schemas/IncidentRecordSource"
- description: Details about the action that started the incident.
lastModifiedBy:
allOf:
- $ref: "#/components/schemas/Arn"
- description: Who modified the incident most recently.
lastModifiedTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The time at which the incident was most recently modified.
notificationTargets:
allOf:
- $ref: "#/components/schemas/NotificationTargetSet"
- description: The Amazon SNS targets that are notified when updates are made to an incident.
resolvedTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The time at which the incident was resolved. This appears as a timeline event.
status:
allOf:
- $ref: "#/components/schemas/IncidentRecordStatus"
- description: The current status of the incident.
summary:
allOf:
- $ref: "#/components/schemas/IncidentSummary"
- description: The summary of the incident. The summary is a brief synopsis of what occurred, what's currently happening, and context of the incident.
title:
allOf:
- $ref: "#/components/schemas/IncidentTitle"
- description: The title of the incident.
description: The record of the incident that's created when an incident occurs.
GetReplicationSetInput:
type: object
title: GetReplicationSetInput
properties: {}
ReplicationSet:
type: object
required:
- createdBy
- createdTime
- deletionProtected
- lastModifiedBy
- lastModifiedTime
- regionMap
- status
properties:
arn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the replication set.
createdBy:
allOf:
- $ref: "#/components/schemas/Arn"
- description: Details about who created the replication set.
createdTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: When the replication set was created.
deletionProtected:
allOf:
- $ref: "#/components/schemas/Boolean"
- description: "Determines if the replication set deletion protection is enabled or not. If deletion protection is enabled, you can't delete the last Amazon Web Services Region in the replication
set. "
lastModifiedBy:
allOf:
- $ref: "#/components/schemas/Arn"
- description: Who last modified the replication set.
lastModifiedTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: When the replication set was last updated.
regionMap:
allOf:
- $ref: "#/components/schemas/RegionInfoMap"
- description: The map between each Amazon Web Services Region in your replication set and the KMS key that's used to encrypt the data in that Region.
status:
allOf:
- $ref: "#/components/schemas/ReplicationSetStatus"
- description: The status of the replication set. If the replication set is still pending, you can't use Incident Manager functionality.
description: "The set of Amazon Web Services Region that your Incident Manager data will be replicated to and the KMS key used to encrypt the data. "
MaxResults:
type: integer
minimum: 1
maximum: 100
NextToken:
type: string
minLength: 0
maxLength: 2000
GetResourcePoliciesInput:
type: object
title: GetResourcePoliciesInput
properties:
maxResults:
allOf:
- $ref: "#/components/schemas/MaxResults"
- description: The maximum number of resource policies to display for each page of results.
nextToken:
allOf:
- $ref: "#/components/schemas/NextToken"
- description: The pagination token to continue to the next page of results.
ResourcePolicyList:
type: array
items:
$ref: "#/components/schemas/ResourcePolicy"
minItems: 0
maxItems: 100
GetResponsePlanInput:
type: object
title: GetResponsePlanInput
properties: {}
GetTimelineEventInput:
type: object
title: GetTimelineEventInput
properties: {}
TimelineEvent:
type: object
required:
- eventData
- eventId
- eventTime
- eventType
- eventUpdatedTime
- incidentRecordArn
properties:
eventData:
allOf:
- $ref: "#/components/schemas/EventData"
- description: A short description of the event.
eventId:
allOf:
- $ref: "#/components/schemas/UUID"
- description: The ID of the timeline event.
eventReferences:
allOf:
- $ref: "#/components/schemas/EventReferenceList"
- description: A list of references in a TimelineEvent.
eventTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The time that the event occurred.
eventType:
allOf:
- $ref: "#/components/schemas/TimelineEventType"
- description: The type of event that occurred. Currently Incident Manager supports only the Custom Event type.
eventUpdatedTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The time that the timeline event was last updated.
incidentRecordArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the incident that the event occurred during.
description: "A significant event that happened during the incident. "
IncidentRecordSource:
type: object
required:
- createdBy
- source
properties:
createdBy:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The principal that started the incident.
invokedBy:
allOf:
- $ref: "#/components/schemas/ServicePrincipal"
- description: The service principal that assumed the role specified in createdBy. If no service principal assumed the role this will be left blank.
resourceArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The resource that caused the incident to be created.
source:
allOf:
- $ref: "#/components/schemas/IncidentSource"
- description: 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.
description: Details about what created the incident record and when it was created.
IncidentRecordStatus:
type: string
enum:
- OPEN
- RESOLVED
ServicePrincipal:
type: string
minLength: 0
maxLength: 1000
IncidentRecordSummary:
type: object
required:
- arn
- creationTime
- impact
- incidentRecordSource
- status
- title
properties:
arn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the incident.
creationTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The time the incident was created.
impact:
allOf:
- $ref: "#/components/schemas/Impact"
- description: Defines the impact to customers and applications.
incidentRecordSource:
allOf:
- $ref: "#/components/schemas/IncidentRecordSource"
- description: What caused Incident Manager to create the incident.
resolvedTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The time the incident was resolved.
status:
allOf:
- $ref: "#/components/schemas/IncidentRecordStatus"
- description: The current status of the incident.
title:
allOf:
- $ref: "#/components/schemas/IncidentTitle"
- description: The title of the incident. This value is either provided by the response plan or overwritten on creation.
description: Details describing an incident record.
IncidentRecordSummaryList:
type: array
items:
$ref: "#/components/schemas/IncidentRecordSummary"
minItems: 0
maxItems: 100
Integer:
type: integer
PagerDutyConfiguration:
type: object
required:
- name
- pagerDutyIncidentConfiguration
- secretId
properties:
name:
allOf:
- $ref: "#/components/schemas/PagerDutyConfigurationNameString"
- description: The name of the PagerDuty configuration.
pagerDutyIncidentConfiguration:
allOf:
- $ref: "#/components/schemas/PagerDutyIncidentConfiguration"
- description: Details about the PagerDuty service associated with the configuration.
secretId:
allOf:
- $ref: "#/components/schemas/PagerDutyConfigurationSecretIdString"
- description: The ID of the Amazon Web Services 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.
description: Details about the PagerDuty configuration for a response plan.
ItemType:
type: string
enum:
- ANALYSIS
- INCIDENT
- METRIC
- PARENT
- ATTACHMENT
- OTHER
- AUTOMATION
- INVOLVED_RESOURCE
- TASK
ItemValue:
type: object
properties:
arn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the related item, if the related item is an Amazon resource.
metricDefinition:
allOf:
- $ref: "#/components/schemas/MetricDefinition"
- description: The metric definition, if the related item is a metric in Amazon CloudWatch.
pagerDutyIncidentDetail:
allOf:
- $ref: "#/components/schemas/PagerDutyIncidentDetail"
- description: Details about an incident that is associated with a PagerDuty incident.
url:
allOf:
- $ref: "#/components/schemas/Url"
- description: The URL, if the related item is a non-Amazon Web Services resource.
description: Describes a related item.
MetricDefinition:
type: string
minLength: 0
maxLength: 4000
PagerDutyIncidentDetail:
type: object
required:
- id
properties:
autoResolve:
allOf:
- $ref: "#/components/schemas/Boolean"
- description: Indicates whether to resolve the PagerDuty incident when you resolve the associated Incident Manager incident.
id:
allOf:
- $ref: "#/components/schemas/PagerDutyIncidentDetailIdString"
- description: The ID of the incident associated with the PagerDuty service for the response plan.
secretId:
allOf:
- $ref: "#/components/schemas/PagerDutyIncidentDetailSecretIdString"
- description: The ID of the Amazon Web Services 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.
description: Details about the PagerDuty incident associated with an incident created by an Incident Manager response plan.
Url:
type: string
minLength: 0
maxLength: 1000
ListIncidentRecordsInput:
type: object
title: ListIncidentRecordsInput
properties:
filters:
allOf:
- $ref: "#/components/schemas/FilterList"
- description: Filters the list of incident records you want to search through. You can filter on the following keys:
creationTime
impact
status
createdBy
Note the following when when you use Filters:
If you don't specify a Filter, the response includes all incident records.
If you specify more than one filter in a single request, the response returns incident records that match all filters.
If you specify a filter with more than one value, the response returns incident records that match any of the values provided.
Filters the timeline events based on the provided conditional values. You can filter timeline events with the following keys:
eventTime
eventType
Note the following when deciding how to use Filters:
If you don't specify a Filter, the response includes all timeline events.
If you specify more than one filter in a single request, the response returns timeline events that match all filters.
If you specify a filter with more than one value, the response returns timeline events that match any of the values provided.
sortBy field.
PagerDutyConfigurationNameString:
type: string
minLength: 1
maxLength: 200
PagerDutyIncidentConfiguration:
type: object
required:
- serviceId
properties:
serviceId:
allOf:
- $ref: "#/components/schemas/PagerDutyIncidentConfigurationServiceIdString"
- description: The ID of the PagerDuty service that the response plan associates with an incident when it launches.
description: Details about the PagerDuty service where the response plan creates an incident.
PagerDutyConfigurationSecretIdString:
type: string
minLength: 1
maxLength: 512
PagerDutyIncidentConfigurationServiceIdString:
type: string
minLength: 1
maxLength: 200
PagerDutyIncidentDetailIdString:
type: string
minLength: 1
maxLength: 200
PagerDutyIncidentDetailSecretIdString:
type: string
minLength: 1
maxLength: 512
Policy:
type: string
minLength: 0
maxLength: 4000
PutResourcePolicyInput:
type: object
required:
- policy
- resourceArn
title: PutResourcePolicyInput
properties:
policy:
allOf:
- $ref: "#/components/schemas/Policy"
- description: Details of the resource policy.
resourceArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the response plan to add the resource policy to.
RegionStatus:
type: string
enum:
- ACTIVE
- CREATING
- DELETING
- FAILED
RegionInfo:
type: object
required:
- status
- statusUpdateDateTime
properties:
sseKmsKeyId:
allOf:
- $ref: "#/components/schemas/SseKmsKey"
- description: The ID of the KMS key used to encrypt the data in this Amazon Web Services Region.
status:
allOf:
- $ref: "#/components/schemas/RegionStatus"
- description: The status of the Amazon Web Services Region in the replication set.
statusMessage:
allOf:
- $ref: "#/components/schemas/String"
- description: Information displayed about the status of the Amazon Web Services Region.
statusUpdateDateTime:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The most recent date and time that Incident Manager updated the Amazon Web Services Region's status.
description: Information about a Amazon Web Services Region in your replication set.
RegionInfoMap:
type: object
additionalProperties:
$ref: "#/components/schemas/RegionInfo"
RelatedItemTitleString:
type: string
minLength: 0
maxLength: 200
RelatedItemsUpdate:
type: object
properties:
itemToAdd:
allOf:
- $ref: "#/components/schemas/RelatedItem"
- description: Details about the related item you're adding.
itemToRemove:
allOf:
- $ref: "#/components/schemas/ItemIdentifier"
- description: Details about the related item you're deleting.
description: Details about the related item you're adding.
ReplicationSetStatus:
type: string
enum:
- ACTIVE
- CREATING
- UPDATING
- DELETING
- FAILED
ResourcePolicy:
type: object
required:
- policyDocument
- policyId
- ramResourceShareRegion
properties:
policyDocument:
allOf:
- $ref: "#/components/schemas/Policy"
- description: The JSON blob that describes the policy.
policyId:
allOf:
- $ref: "#/components/schemas/PolicyId"
- description: The ID of the resource policy.
ramResourceShareRegion:
allOf:
- $ref: "#/components/schemas/String"
- description: The Amazon Web Services Region that policy allows resources to be used in.
description: The resource policy that allows Incident Manager to perform actions on resources on your behalf.
ResponsePlanSummary:
type: object
required:
- arn
- name
properties:
arn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the response plan.
displayName:
allOf:
- $ref: "#/components/schemas/ResponsePlanDisplayName"
- description: The human readable name of the response plan. This can include spaces.
name:
allOf:
- $ref: "#/components/schemas/ResponsePlanName"
- description: The name of the response plan. This can't include spaces.
description: Details of the response plan that are used when creating an incident.
RoleArn:
type: string
pattern: ^arn:aws(-cn|-us-gov)?:iam::([0-9]{12})?:role/.+$
minLength: 0
maxLength: 1000
SsmAutomationDocumentNameString:
type: string
pattern: ^[a-zA-Z0-9_\-.:/]{3,128}$
SsmAutomationDocumentVersionString:
type: string
minLength: 0
maxLength: 128
SsmParameters:
type: object
minProperties: 1
maxProperties: 200
additionalProperties:
$ref: "#/components/schemas/SsmParameterValues"
SsmTargetAccount:
type: string
enum:
- RESPONSE_PLAN_OWNER_ACCOUNT
- IMPACTED_ACCOUNT
SsmParameterValuesMemberString:
type: string
minLength: 0
maxLength: 512
SsmParameterValues:
type: array
items:
$ref: "#/components/schemas/SsmParameterValuesMemberString"
minItems: 0
maxItems: 100
SsmParametersKeyString:
type: string
minLength: 1
maxLength: 50
TriggerDetails:
type: object
required:
- source
- timestamp
properties:
rawData:
allOf:
- $ref: "#/components/schemas/RawData"
- description: Raw data passed from either Amazon EventBridge, Amazon CloudWatch, or Incident Manager when an incident is created.
source:
allOf:
- $ref: "#/components/schemas/IncidentSource"
- description: "Identifies the service that sourced the event. All events sourced from within Amazon Web Services begin with \"aws.\" Customer-generated events can have any value
here, as long as it doesn't begin with \"aws.\" We recommend the use of Java package-name style reverse domain-name strings. "
timestamp:
allOf:
- $ref: "#/components/schemas/Timestamp"
- description: The time that the incident was detected.
triggerArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the source that detected the incident.
description: Details about what caused the incident to be created in Incident Manager.
StartIncidentInput:
type: object
required:
- responsePlanArn
title: StartIncidentInput
properties:
clientToken:
allOf:
- $ref: "#/components/schemas/ClientToken"
- description: A token ensuring that the operation is called only once with the specified details.
impact:
allOf:
- $ref: "#/components/schemas/Impact"
- description: 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.
Defines the impact of the incident to customers and applications. If you provide an impact for an incident, it overwrites the impact provided by the response plan.
Possible impacts:
1 - Critical impact, 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 aren't impacted by the problem yet.
5 - No impact, customers aren't currently
impacted but urgent action is needed to avoid impact.
The Amazon SNS targets that Incident Manager notifies when a client updates an incident.
Using multiple SNS topics creates redundancy in the event that a Region is down during the incident.
status: allOf: - $ref: "#/components/schemas/IncidentRecordStatus" - description: The status of the incident. Possible statuses areOpen or Resolved.
summary:
allOf:
- $ref: "#/components/schemas/IncidentSummary"
- description: A longer description of what occurred during the incident.
title:
allOf:
- $ref: "#/components/schemas/IncidentTitle"
- description: A brief description of the incident.
UpdateRelatedItemsInput:
type: object
required:
- incidentRecordArn
- relatedItemsUpdate
title: UpdateRelatedItemsInput
properties:
clientToken:
allOf:
- $ref: "#/components/schemas/ClientToken"
- description: A token that ensures that a client calls the operation only once with the specified details.
incidentRecordArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the incident record that contains the related items that you update.
relatedItemsUpdate:
allOf:
- $ref: "#/components/schemas/RelatedItemsUpdate"
- description: Details about the item that you are add to, or delete from, an incident.
UpdateReplicationSetInputActionsList:
type: array
items:
$ref: "#/components/schemas/UpdateReplicationSetAction"
minItems: 1
maxItems: 1
UpdateReplicationSetInput:
type: object
required:
- actions
- arn
title: UpdateReplicationSetInput
properties:
actions:
allOf:
- $ref: "#/components/schemas/UpdateReplicationSetInputActionsList"
- description: An action to add or delete a Region.
arn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the replication set you're updating.
clientToken:
allOf:
- $ref: "#/components/schemas/ClientToken"
- description: A token that ensures that the operation is called only once with the specified details.
UpdateResponsePlanInput:
type: object
required:
- arn
title: UpdateResponsePlanInput
properties:
actions:
allOf:
- $ref: "#/components/schemas/ActionsList"
- description: The actions that this response plan takes at the beginning of an incident.
arn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the response plan.
chatChannel:
allOf:
- $ref: "#/components/schemas/ChatChannel"
- description: The Chatbot chat channel used for collaboration during an incident.
Use the empty structure to remove the chat channel from the response plan.
clientToken: allOf: - $ref: "#/components/schemas/ClientToken" - description: A token ensuring that the operation is called only once with the specified details. displayName: allOf: - $ref: "#/components/schemas/ResponsePlanDisplayName" - description: The long format name of the response plan. The display name can't contain spaces. engagements: allOf: - $ref: "#/components/schemas/EngagementSet" - description: The Amazon Resource Name (ARN) for the contacts and escalation plans that the response plan engages during an incident. incidentTemplateDedupeString: allOf: - $ref: "#/components/schemas/DedupeString" - description: The string Incident Manager uses to prevent duplicate incidents from being created by the same incident in the same account. incidentTemplateImpact: allOf: - $ref: "#/components/schemas/Impact" - description: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
StartIncident API action is called, Incident Manager assigns the tags specified in the template to the incident. To call
this action, you must also have permission to call the TagResource API action for the incident record resource.
incidentTemplateTitle:
allOf:
- $ref: "#/components/schemas/IncidentTitle"
- description: The short format name of the incident. The title can't contain spaces.
integrations:
allOf:
- $ref: "#/components/schemas/Integrations"
- description: Information about third-party services integrated into the response plan.
UpdateTimelineEventInput:
type: object
required:
- eventId
- incidentRecordArn
title: UpdateTimelineEventInput
properties:
clientToken:
allOf:
- $ref: "#/components/schemas/ClientToken"
- description: A token that ensures that a client calls the operation only once with the specified details.
eventData:
allOf:
- $ref: "#/components/schemas/EventData"
- description: A short description of the event.
eventId:
allOf:
- $ref: "#/components/schemas/UUID"
- description: The ID of the event to update. You can use ListTimelineEvents to find an event's ID.
eventReferences:
allOf:
- $ref: "#/components/schemas/EventReferenceList"
- description: Updates all existing references in a TimelineEvent. A reference is an Amazon Web Services resource involved or associated with the incident. To specify a
reference, enter its Amazon Resource Name (ARN). You can also specify a related item associated with that resource. For example, to specify an Amazon DynamoDB (DynamoDB) table as a
resource, use its ARN. You can also specify an Amazon CloudWatch metric associated with the DynamoDB table as a related item.
This update action overrides all existing references. If you want to keep existing references, you must specify them in the call. If you don't, this action removes any existing references and enters only new references.
Custom Event.
incidentRecordArn:
allOf:
- $ref: "#/components/schemas/Arn"
- description: The Amazon Resource Name (ARN) of the incident that includes the timeline event.
security:
- hmac: []