Amazon Incident Manager Update Response Plan API

openapi: 3.2.0
info:
  version: 2018-05-10
  x-release: v4
  title: AWS Systems Manager Incident Manager Update Response Plan…
  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.
  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
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)
security:
- hmac: []
tags:
- name: Update Response Plan
paths:
  /updateResponsePlan:
    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'
    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: <p>Defines the impact to the customers. Providing an impact overwrites the impact provided by a response plan.</p> <p class="title"> <b>Possible impacts:</b> </p> <ul> <li> <p> <code>5</code> - Severe impact</p> </li> <li> <p> <code>4</code> - High impact</p> </li> <li> <p> <code>3</code> - Medium impact</p> </li> <li> <p> <code>2</code> - Low impact</p> </li> <li> <p> <code>1</code> - No impact</p> </li> </ul>
                  type: integer
                  minimum: 1
                  maximum: 5
                incidentTemplateNotificationTargets:
                  description: The Amazon SNS targets that are notified when updates are made to an incident.
                  type: array
                  items:
                    $ref: '#/components/schemas/NotificationTargetItem'
                  minItems: 0
                  maxItems: 10
                incidentTemplateSummary:
                  description: A brief summary of the incident. This typically contains what has happened, what's currently happening, and next steps.
                  type: string
                  minLength: 0
                  maxLength: 8000
                incidentTemplateTags:
                  description: Tags to assign to the template. When the <code>StartIncident</code> 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 <code>TagResource</code> 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
      tags:
      - Update Response Plan
components:
  schemas:
    TagValue:
      type: string
      pattern: ^[A-Za-z0-9 _=@:.+-/]*$
      minLength: 0
      maxLength: 256
    UpdateResponsePlanOutput:
      type: object
      properties: {}
    ThrottlingException: {}
    PagerDutyConfigurationSecretIdString:
      type: string
      minLength: 1
      maxLength: 512
    SsmParameterValues:
      type: array
      items:
        $ref: '#/components/schemas/SsmParameterValuesMemberString'
      minItems: 0
      maxItems: 100
    SsmParameterValuesMemberString:
      type: string
      minLength: 0
      maxLength: 512
    ConflictException: {}
    SsmAutomationDocumentNameString:
      type: string
      pattern: ^[a-zA-Z0-9_\-.:/]{3,128}$
    Arn:
      type: string
      pattern: ^arn:aws(-cn|-us-gov)?:[a-z0-9-]*:[a-z0-9-]*:([0-9]{12})?:.+$
      minLength: 0
      maxLength: 1000
    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.
    ValidationException: {}
    SnsArn:
      type: string
      minLength: 0
      maxLength: 1000
    PagerDutyIncidentConfigurationServiceIdString:
      type: string
      minLength: 1
      maxLength: 200
    ChatbotSnsConfigurationSet:
      type: array
      items:
        $ref: '#/components/schemas/SnsArn'
      minItems: 1
      maxItems: 5
    ResourceNotFoundException: {}
    InternalServerException: {}
    EmptyChatChannel:
      type: object
      properties: {}
      description: Used to remove the chat channel from an incident record or 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.
    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
    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.
    SsmAutomation:
      type: object
      required:
      - documentName
      - roleArn
      properties:
        documentName:
          allOf:
          - $ref: '#/components/schemas/SsmAutomationDocumentNameString'
          - description: The automation document's name.
        documentVersion:
          allOf:
          - $ref: '#/components/schemas/SsmAutomationDocumentVersionString'
          - description: The automation document's version to use when running.
        dynamicParameters:
          allOf:
          - $ref: '#/components/schemas/DynamicSsmParameters'
          - description: The key-value pair to resolve dynamic parameter values when processing a Systems Manager Automation runbook.
        parameters:
          allOf:
          - $ref: '#/components/schemas/SsmParameters'
          - description: The key-value pair parameters to use when running the automation document.
        roleArn:
          allOf:
          - $ref: '#/components/schemas/RoleArn'
          - description: The Amazon Resource Name (ARN) of the role that the automation document will assume when running commands.
        targetAccount:
          allOf:
          - $ref: '#/components/schemas/SsmTargetAccount'
          - description: The account that the automation document will be run in. This can be in either the management account or an application account.
      description: Details about the Systems Manager automation document that will be used as a runbook during an incident.
    SsmTargetAccount:
      type: string
      enum:
      - RESPONSE_PLAN_OWNER_ACCOUNT
      - IMPACTED_ACCOUNT
    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.
    RoleArn:
      type: string
      pattern: ^arn:aws(-cn|-us-gov)?:iam::([0-9]{12})?:role/.+$
      minLength: 0
      maxLength: 1000
    NotificationTargetItem:
      type: object
      properties:
        snsTopicArn:
          allOf:
          - $ref: '#/components/schemas/Arn'
          - description: The Amazon Resource Name (ARN) of the SNS topic.
      description: The SNS targets that are notified when updates are made to an incident.
    PagerDutyConfigurationNameString:
      type: string
      minLength: 1
      maxLength: 200
    AccessDeniedException: {}
    DynamicSsmParameters:
      type: object
      minProperties: 1
      maxProperties: 200
      additionalProperties:
        $ref: '#/components/schemas/DynamicSsmParameterValue'
    SsmParameters:
      type: object
      minProperties: 1
      maxProperties: 200
      additionalProperties:
        $ref: '#/components/schemas/SsmParameterValues'
    SsmAutomationDocumentVersionString:
      type: string
      minLength: 0
      maxLength: 128
    VariableType:
      type: string
      enum:
      - INCIDENT_RECORD_ARN
      - INVOLVED_RESOURCES
    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.
  parameters:
    X-Amz-Date:
      name: X-Amz-Date
      in: header
      schema:
        type: string
      required: false
    X-Amz-SignedHeaders:
      name: X-Amz-SignedHeaders
      in: header
      schema:
        type: string
      required: false
    X-Amz-Signature:
      name: X-Amz-Signature
      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-Credential:
      name: X-Amz-Credential
      in: header
      schema:
        type: string
      required: false
    X-Amz-Algorithm:
      name: X-Amz-Algorithm
      in: header
      schema:
        type: string
      required: false
    X-Amz-Content-Sha256:
      name: X-Amz-Content-Sha256
      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
externalDocs:
  description: Amazon Web Services documentation
  url: https://docs.aws.amazon.com/ssm-incidents/
x-hasEquivalentPaths: true