aws-sdk-ssmincidents 1.17.0 → 1.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19a074a8b83472def3fd2da179c21a308c38975812552b23b5fdd5e5ff2238ad
-  data.tar.gz: 66d836684f3b20a2deda71a0444747cd934fa05d0df6b624655b28140f1fb36e
+  metadata.gz: f6b2ee80c3185adba475faa323cdcb7aad23956b8e8bed5c0df3618fc028c0c2
+  data.tar.gz: f6a3606e949f6714d562b103cb01827cae2a8bda0ded4a4cdc05d4818317cf3d
 SHA512:
-  metadata.gz: 898f10f9299a158241ffa45ec29d945d910036b268569c3cab7db03b077aa307f06330737e2a6097cf08eed4fd21b0bb8e3e36a2fa4e56c1f08427fafa2ac93b
-  data.tar.gz: 6cad5f02e017f249b311ba73768412fc5eddae876802381b67abc4dd2e1f3e41d185dbb5d3e557d64ee8fee1cb8dda14cdaaea5149648110dac78424768e3ee5
+  metadata.gz: 4b68cd0b5b91f49994327420859795ba8210ea29e8d5f0a00fbfa5bd35d70b310a69758c181b4d1258b9ab729eba46aaa698bcda3d8c065d39474755459beebd
+  data.tar.gz: 9ce6c014fb9b1f9370d6991cfe00dd21b9b46840974f5ffa71cd4ab2b6e3c2e852621fc231ab09dcac009dd436bd5fef09d68f5440e762bc94381fe3b30988f2

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.19.0 (2022-11-11)
+------------------
+
+* Feature - RelatedItems now have an ID field which can be used for referencing them else where. Introducing event references in TimelineEvent API and increasing maximum length of "eventData" to 12K characters.
+
+1.18.0 (2022-11-02)
+------------------
+
+* Feature - Adds support for tagging replication-set on creation.
+
 1.17.0 (2022-10-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.17.0
+1.19.0

data/lib/aws-sdk-ssmincidents/client.rb

@@ -372,7 +372,7 @@ module Aws::SSMIncidents
     # Regions with the provided KMS key.
     #
     # @option params [String] :client_token
-    #   A token ensuring that the operation is called only once with the
+    #   A token that ensures that the operation is called only once with the
     #   specified details.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -382,6 +382,9 @@ module Aws::SSMIncidents
     #   The Regions that Incident Manager replicates your data to. You can
     #   have up to three Regions in your replication set.
     #
+    # @option params [Hash<String,String>] :tags
+    #   A list of tags to add to the replication set.
+    #
     # @return [Types::CreateReplicationSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateReplicationSetOutput#arn #arn} => String
@@ -395,6 +398,9 @@ module Aws::SSMIncidents
     #         sse_kms_key_id: "SseKmsKey",
     #       },
     #     },
+    #     tags: {
+    #       "TagKey" => "TagValue",
+    #     },
     #   })
     #
     # @example Response structure
@@ -433,8 +439,8 @@ module Aws::SSMIncidents
     #   spaces.
     #
     # @option params [Array<String>] :engagements
-    #   The contacts and escalation plans that the response plan engages
-    #   during an incident.
+    #   The Amazon Resource Name (ARN) for the contacts and escalation plans
+    #   that the response plan engages during an incident.
     #
     # @option params [required, Types::IncidentTemplate] :incident_template
     #   Details used to create an incident when using this response plan.
@@ -527,6 +533,16 @@ module Aws::SSMIncidents
     # @option params [required, String] :event_data
     #   A short description of the event.
     #
+    # @option params [Array<Types::EventReference>] :event_references
+    #   Adds one or more references to the `TimelineEvent`. A reference can be
+    #   an Amazon Web Services resource involved in the incident or in some
+    #   way associated with it. When you specify a reference, you enter the
+    #   Amazon Resource Name (ARN) of the resource. You can also specify a
+    #   related item. As an example, you could specify the ARN of an Amazon
+    #   DynamoDB (DynamoDB) table. The table for this example is the resource.
+    #   You could also specify a Amazon CloudWatch metric for that table. The
+    #   metric is the related item.
+    #
     # @option params [required, Time,DateTime,Date,Integer,String] :event_time
     #   The time that the event occurred.
     #
@@ -548,6 +564,12 @@ module Aws::SSMIncidents
     #   resp = client.create_timeline_event({
     #     client_token: "ClientToken",
     #     event_data: "EventData", # required
+    #     event_references: [
+    #       {
+    #         related_item_id: "GeneratedId",
+    #         resource: "Arn",
+    #       },
+    #     ],
     #     event_time: Time.now, # required
     #     event_type: "TimelineEventType", # required
     #     incident_record_arn: "Arn", # required
@@ -791,7 +813,7 @@ module Aws::SSMIncidents
     # plan.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of resource policies to display per page of
+    #   The maximum number of resource policies to display for each page of
     #   results.
     #
     # @option params [String] :next_token
@@ -916,6 +938,9 @@ module Aws::SSMIncidents
     #
     #   resp.event.event_data #=> String
     #   resp.event.event_id #=> String
+    #   resp.event.event_references #=> Array
+    #   resp.event.event_references[0].related_item_id #=> String
+    #   resp.event.event_references[0].resource #=> String
     #   resp.event.event_time #=> Time
     #   resp.event.event_type #=> String
     #   resp.event.event_updated_time #=> Time
@@ -1045,6 +1070,7 @@ module Aws::SSMIncidents
     #
     #   resp.next_token #=> String
     #   resp.related_items #=> Array
+    #   resp.related_items[0].generated_id #=> String
     #   resp.related_items[0].identifier.type #=> String, one of "ANALYSIS", "INCIDENT", "METRIC", "PARENT", "ATTACHMENT", "OTHER", "AUTOMATION", "INVOLVED_RESOURCE", "TASK"
     #   resp.related_items[0].identifier.value.arn #=> String
     #   resp.related_items[0].identifier.value.metric_definition #=> String
@@ -1237,6 +1263,9 @@ module Aws::SSMIncidents
     #
     #   resp.event_summaries #=> Array
     #   resp.event_summaries[0].event_id #=> String
+    #   resp.event_summaries[0].event_references #=> Array
+    #   resp.event_summaries[0].event_references[0].related_item_id #=> String
+    #   resp.event_summaries[0].event_references[0].resource #=> String
     #   resp.event_summaries[0].event_time #=> Time
     #   resp.event_summaries[0].event_type #=> String
     #   resp.event_summaries[0].event_updated_time #=> Time
@@ -1255,17 +1284,17 @@ module Aws::SSMIncidents
     # 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
-    # [Setting up cross-account functionality][1].
+    # [Cross-Region and cross-account incident management][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/incident-manager/latest/userguide/xa.html
+    # [1]: https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-manager-cross-account-cross-region.html
     #
     # @option params [required, String] :policy
     #   Details of the resource policy.
     #
     # @option params [required, String] :resource_arn
-    #   The Amazon Resource Name (ARN) of the response plan you're adding the
+    #   The Amazon Resource Name (ARN) of the response plan to add the
     #   resource policy to.
     #
     # @return [Types::PutResourcePolicyOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1351,6 +1380,7 @@ module Aws::SSMIncidents
     #     impact: 1,
     #     related_items: [
     #       {
+    #         generated_id: "GeneratedId",
     #         identifier: { # required
     #           type: "ANALYSIS", # required, accepts ANALYSIS, INCIDENT, METRIC, PARENT, ATTACHMENT, OTHER, AUTOMATION, INVOLVED_RESOURCE, TASK
     #           value: { # required
@@ -1392,7 +1422,7 @@ module Aws::SSMIncidents
     #   tags to.
     #
     # @option params [required, Hash<String,String>] :tags
-    #   A list of tags that you are adding to the response plan.
+    #   A list of tags to add to the response plan.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1421,7 +1451,7 @@ module Aws::SSMIncidents
     #   tag from.
     #
     # @option params [required, Array<String>] :tag_keys
-    #   The name of the tag you're removing from the response plan.
+    #   The name of the tag to remove from the response plan.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1445,18 +1475,17 @@ module Aws::SSMIncidents
     # final Region in a replication set.
     #
     # @option params [required, String] :arn
-    #   The Amazon Resource Name (ARN) of the replication set you're
-    #   updating.
+    #   The Amazon Resource Name (ARN) of the replication set to update.
     #
     # @option params [String] :client_token
-    #   A token ensuring that the operation is called only once with the
+    #   A token that ensures that the operation is called only once with the
     #   specified details.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
     # @option params [required, Boolean] :deletion_protected
-    #   Details if deletion protection is enabled or disabled in your account.
+    #   Specifies if deletion protection is turned on or off in your account.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1595,6 +1624,7 @@ module Aws::SSMIncidents
     #     incident_record_arn: "Arn", # required
     #     related_items_update: { # required
     #       item_to_add: {
+    #         generated_id: "GeneratedId",
     #         identifier: { # required
     #           type: "ANALYSIS", # required, accepts ANALYSIS, INCIDENT, METRIC, PARENT, ATTACHMENT, OTHER, AUTOMATION, INVOLVED_RESOURCE, TASK
     #           value: { # required
@@ -1635,7 +1665,7 @@ module Aws::SSMIncidents
     #   updating.
     #
     # @option params [String] :client_token
-    #   A token ensuring that the operation is called only once with the
+    #   A token that ensures that the operation is called only once with the
     #   specified details.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -1697,8 +1727,8 @@ module Aws::SSMIncidents
     #   contain spaces.
     #
     # @option params [Array<String>] :engagements
-    #   The contacts and escalation plans that Incident Manager engages at the
-    #   start of the incident.
+    #   The Amazon Resource Name (ARN) for the contacts and escalation plans
+    #   that the response plan engages during an incident.
     #
     # @option params [String] :incident_template_dedupe_string
     #   The string Incident Manager uses to prevent duplicate incidents from
@@ -1729,9 +1759,10 @@ module Aws::SSMIncidents
     #   happened, what's currently happening, and next steps.
     #
     # @option params [Hash<String,String>] :incident_template_tags
-    #   Tags to apply to an incident when calling the `StartIncident` API
-    #   action. To call this action, you must also have permission to call the
-    #   `TagResource` API action for the incident record resource.
+    #   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. To call this action, you must also have permission to
+    #   call the `TagResource` API action for the incident record resource.
     #
     # @option params [String] :incident_template_title
     #   The short format name of the incident. The title can't contain
@@ -1809,6 +1840,20 @@ module Aws::SSMIncidents
     #   The ID of the event you are updating. You can find this by using
     #   `ListTimelineEvents`.
     #
+    # @option params [Array<Types::EventReference>] :event_references
+    #   Updates all existing references in a `TimelineEvent`. A reference can
+    #   be an Amazon Web Services resource involved in the incident or in some
+    #   way associated with it. When you specify a reference, you enter the
+    #   Amazon Resource Name (ARN) of the resource. You can also specify a
+    #   related item. As an example, you could specify the ARN of an Amazon
+    #   DynamoDB (DynamoDB) table. The table for this example is the resource.
+    #   You could also specify a Amazon CloudWatch metric for that table. The
+    #   metric is the 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 them and enters only new references.
+    #
     # @option params [Time,DateTime,Date,Integer,String] :event_time
     #   The time that the event occurred.
     #
@@ -1827,6 +1872,12 @@ module Aws::SSMIncidents
     #     client_token: "ClientToken",
     #     event_data: "EventData",
     #     event_id: "UUID", # required
+    #     event_references: [
+    #       {
+    #         related_item_id: "GeneratedId",
+    #         resource: "Arn",
+    #       },
+    #     ],
     #     event_time: Time.now,
     #     event_type: "TimelineEventType",
     #     incident_record_arn: "Arn", # required
@@ -1854,7 +1905,7 @@ module Aws::SSMIncidents
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ssmincidents'
-      context[:gem_version] = '1.17.0'
+      context[:gem_version] = '1.19.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-ssmincidents/client_api.rb

@@ -51,12 +51,15 @@ module Aws::SSMIncidents
     EmptyChatChannel = Shapes::StructureShape.new(name: 'EmptyChatChannel')
     EngagementSet = Shapes::ListShape.new(name: 'EngagementSet')
     EventData = Shapes::StringShape.new(name: 'EventData')
+    EventReference = Shapes::UnionShape.new(name: 'EventReference')
+    EventReferenceList = Shapes::ListShape.new(name: 'EventReferenceList')
     EventSummary = Shapes::StructureShape.new(name: 'EventSummary')
     EventSummaryList = Shapes::ListShape.new(name: 'EventSummaryList')
     ExceptionMessage = Shapes::StringShape.new(name: 'ExceptionMessage')
     Filter = Shapes::StructureShape.new(name: 'Filter')
     FilterKeyString = Shapes::StringShape.new(name: 'FilterKeyString')
     FilterList = Shapes::ListShape.new(name: 'FilterList')
+    GeneratedId = Shapes::StringShape.new(name: 'GeneratedId')
     GetIncidentRecordInput = Shapes::StructureShape.new(name: 'GetIncidentRecordInput')
     GetIncidentRecordOutput = Shapes::StructureShape.new(name: 'GetIncidentRecordOutput')
     GetReplicationSetInput = Shapes::StructureShape.new(name: 'GetReplicationSetInput')
@@ -240,6 +243,7 @@ module Aws::SSMIncidents
 
     CreateReplicationSetInput.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "clientToken", metadata: {"idempotencyToken"=>true}))
     CreateReplicationSetInput.add_member(:regions, Shapes::ShapeRef.new(shape: RegionMapInput, required: true, location_name: "regions"))
+    CreateReplicationSetInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
     CreateReplicationSetInput.struct_class = Types::CreateReplicationSetInput
 
     CreateReplicationSetOutput.add_member(:arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "arn"))
@@ -260,6 +264,7 @@ module Aws::SSMIncidents
 
     CreateTimelineEventInput.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "clientToken", metadata: {"idempotencyToken"=>true}))
     CreateTimelineEventInput.add_member(:event_data, Shapes::ShapeRef.new(shape: EventData, required: true, location_name: "eventData"))
+    CreateTimelineEventInput.add_member(:event_references, Shapes::ShapeRef.new(shape: EventReferenceList, location_name: "eventReferences"))
     CreateTimelineEventInput.add_member(:event_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "eventTime"))
     CreateTimelineEventInput.add_member(:event_type, Shapes::ShapeRef.new(shape: TimelineEventType, required: true, location_name: "eventType"))
     CreateTimelineEventInput.add_member(:incident_record_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "incidentRecordArn"))
@@ -312,7 +317,18 @@ module Aws::SSMIncidents
 
     EngagementSet.member = Shapes::ShapeRef.new(shape: SsmContactsArn)
 
+    EventReference.add_member(:related_item_id, Shapes::ShapeRef.new(shape: GeneratedId, location_name: "relatedItemId"))
+    EventReference.add_member(:resource, Shapes::ShapeRef.new(shape: Arn, location_name: "resource"))
+    EventReference.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    EventReference.add_member_subclass(:related_item_id, Types::EventReference::RelatedItemId)
+    EventReference.add_member_subclass(:resource, Types::EventReference::Resource)
+    EventReference.add_member_subclass(:unknown, Types::EventReference::Unknown)
+    EventReference.struct_class = Types::EventReference
+
+    EventReferenceList.member = Shapes::ShapeRef.new(shape: EventReference)
+
     EventSummary.add_member(:event_id, Shapes::ShapeRef.new(shape: UUID, required: true, location_name: "eventId"))
+    EventSummary.add_member(:event_references, Shapes::ShapeRef.new(shape: EventReferenceList, location_name: "eventReferences"))
     EventSummary.add_member(:event_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "eventTime"))
     EventSummary.add_member(:event_type, Shapes::ShapeRef.new(shape: TimelineEventType, required: true, location_name: "eventType"))
     EventSummary.add_member(:event_updated_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "eventUpdatedTime"))
@@ -509,6 +525,7 @@ module Aws::SSMIncidents
     RegionMapInputValue.add_member(:sse_kms_key_id, Shapes::ShapeRef.new(shape: SseKmsKey, location_name: "sseKmsKeyId"))
     RegionMapInputValue.struct_class = Types::RegionMapInputValue
 
+    RelatedItem.add_member(:generated_id, Shapes::ShapeRef.new(shape: GeneratedId, location_name: "generatedId"))
     RelatedItem.add_member(:identifier, Shapes::ShapeRef.new(shape: ItemIdentifier, required: true, location_name: "identifier"))
     RelatedItem.add_member(:title, Shapes::ShapeRef.new(shape: RelatedItemTitleString, location_name: "title"))
     RelatedItem.struct_class = Types::RelatedItem
@@ -608,6 +625,7 @@ module Aws::SSMIncidents
 
     TimelineEvent.add_member(:event_data, Shapes::ShapeRef.new(shape: EventData, required: true, location_name: "eventData"))
     TimelineEvent.add_member(:event_id, Shapes::ShapeRef.new(shape: UUID, required: true, location_name: "eventId"))
+    TimelineEvent.add_member(:event_references, Shapes::ShapeRef.new(shape: EventReferenceList, location_name: "eventReferences"))
     TimelineEvent.add_member(:event_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "eventTime"))
     TimelineEvent.add_member(:event_type, Shapes::ShapeRef.new(shape: TimelineEventType, required: true, location_name: "eventType"))
     TimelineEvent.add_member(:event_updated_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "eventUpdatedTime"))
@@ -688,6 +706,7 @@ module Aws::SSMIncidents
     UpdateTimelineEventInput.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "clientToken", metadata: {"idempotencyToken"=>true}))
     UpdateTimelineEventInput.add_member(:event_data, Shapes::ShapeRef.new(shape: EventData, location_name: "eventData"))
     UpdateTimelineEventInput.add_member(:event_id, Shapes::ShapeRef.new(shape: UUID, required: true, location_name: "eventId"))
+    UpdateTimelineEventInput.add_member(:event_references, Shapes::ShapeRef.new(shape: EventReferenceList, location_name: "eventReferences"))
     UpdateTimelineEventInput.add_member(:event_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "eventTime"))
     UpdateTimelineEventInput.add_member(:event_type, Shapes::ShapeRef.new(shape: TimelineEventType, location_name: "eventType"))
     UpdateTimelineEventInput.add_member(:incident_record_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "incidentRecordArn"))

data/lib/aws-sdk-ssmincidents/types.rb

@@ -233,10 +233,13 @@ module Aws::SSMIncidents
     #             sse_kms_key_id: "SseKmsKey",
     #           },
     #         },
+    #         tags: {
+    #           "TagKey" => "TagValue",
+    #         },
     #       }
     #
     # @!attribute [rw] client_token
-    #   A token ensuring that the operation is called only once with the
+    #   A token that ensures that the operation is called only once with the
     #   specified details.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -248,11 +251,16 @@ module Aws::SSMIncidents
     #   have up to three Regions in your replication set.
     #   @return [Hash<String,Types::RegionMapInputValue>]
     #
+    # @!attribute [rw] tags
+    #   A list of tags to add to the replication set.
+    #   @return [Hash<String,String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-incidents-2018-05-10/CreateReplicationSetInput AWS API Documentation
     #
     class CreateReplicationSetInput < Struct.new(
       :client_token,
-      :regions)
+      :regions,
+      :tags)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -342,8 +350,8 @@ module Aws::SSMIncidents
     #   @return [String]
     #
     # @!attribute [rw] engagements
-    #   The contacts and escalation plans that the response plan engages
-    #   during an incident.
+    #   The Amazon Resource Name (ARN) for the contacts and escalation plans
+    #   that the response plan engages during an incident.
     #   @return [Array<String>]
     #
     # @!attribute [rw] incident_template
@@ -391,6 +399,12 @@ module Aws::SSMIncidents
     #       {
     #         client_token: "ClientToken",
     #         event_data: "EventData", # required
+    #         event_references: [
+    #           {
+    #             related_item_id: "GeneratedId",
+    #             resource: "Arn",
+    #           },
+    #         ],
     #         event_time: Time.now, # required
     #         event_type: "TimelineEventType", # required
     #         incident_record_arn: "Arn", # required
@@ -408,6 +422,17 @@ module Aws::SSMIncidents
     #   A short description of the event.
     #   @return [String]
     #
+    # @!attribute [rw] event_references
+    #   Adds one or more references to the `TimelineEvent`. A reference can
+    #   be an Amazon Web Services resource involved in the incident or in
+    #   some way associated with it. When you specify a reference, you enter
+    #   the Amazon Resource Name (ARN) of the resource. You can also specify
+    #   a related item. As an example, you could specify the ARN of an
+    #   Amazon DynamoDB (DynamoDB) table. The table for this example is the
+    #   resource. You could also specify a Amazon CloudWatch metric for that
+    #   table. The metric is the related item.
+    #   @return [Array<Types::EventReference>]
+    #
     # @!attribute [rw] event_time
     #   The time that the event occurred.
     #   @return [Time]
@@ -427,6 +452,7 @@ module Aws::SSMIncidents
     class CreateTimelineEventInput < Struct.new(
       :client_token,
       :event_data,
+      :event_references,
       :event_time,
       :event_type,
       :incident_record_arn)
@@ -639,12 +665,48 @@ module Aws::SSMIncidents
     #
     class EmptyChatChannel < Aws::EmptyStructure; end
 
+    # 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.
+    #
+    # @note EventReference is a union - when making an API calls you must set exactly one of the members.
+    #
+    # @note EventReference is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of EventReference corresponding to the set member.
+    #
+    # @!attribute [rw] related_item_id
+    #   The ID of a `RelatedItem` referenced in a `TimelineEvent`.
+    #   @return [String]
+    #
+    # @!attribute [rw] resource
+    #   The Amazon Resource Name (ARN) of an Amazon Web Services resource
+    #   referenced in a `TimelineEvent`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-incidents-2018-05-10/EventReference AWS API Documentation
+    #
+    class EventReference < Struct.new(
+      :related_item_id,
+      :resource,
+      :unknown)
+      SENSITIVE = []
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class RelatedItemId < EventReference; end
+      class Resource < EventReference; end
+      class Unknown < EventReference; end
+    end
+
     # Details about a timeline event during an incident.
     #
     # @!attribute [rw] event_id
     #   The timeline event ID.
     #   @return [String]
     #
+    # @!attribute [rw] event_references
+    #   A list of references in a `TimelineEvent`.
+    #   @return [Array<Types::EventReference>]
+    #
     # @!attribute [rw] event_time
     #   The time that the event occurred.
     #   @return [Time]
@@ -666,6 +728,7 @@ module Aws::SSMIncidents
     #
     class EventSummary < Struct.new(
       :event_id,
+      :event_references,
       :event_time,
       :event_type,
       :event_updated_time,
@@ -782,7 +845,7 @@ module Aws::SSMIncidents
     #       }
     #
     # @!attribute [rw] max_results
-    #   The maximum number of resource policies to display per page of
+    #   The maximum number of resource policies to display for each page of
     #   results.
     #   @return [Integer]
     #
@@ -859,8 +922,8 @@ module Aws::SSMIncidents
     #   @return [String]
     #
     # @!attribute [rw] engagements
-    #   The contacts and escalation plans that the response plan engages
-    #   during an incident.
+    #   The Amazon Resource Name (ARN) for the contacts and escalation plans
+    #   that the response plan engages during an incident.
     #   @return [Array<String>]
     #
     # @!attribute [rw] incident_template
@@ -1119,8 +1182,9 @@ module Aws::SSMIncidents
     #   @return [Integer]
     #
     # @!attribute [rw] incident_tags
-    #   Tags to apply to an incident when calling the `StartIncident` API
-    #   action.
+    #   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.
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] notification_targets
@@ -1609,8 +1673,8 @@ module Aws::SSMIncidents
     #   @return [String]
     #
     # @!attribute [rw] resource_arn
-    #   The Amazon Resource Name (ARN) of the response plan you're adding
-    #   the resource policy to.
+    #   The Amazon Resource Name (ARN) of the response plan to add the
+    #   resource policy to.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-incidents-2018-05-10/PutResourcePolicyInput AWS API Documentation
@@ -1695,6 +1759,7 @@ module Aws::SSMIncidents
     #   data as a hash:
     #
     #       {
+    #         generated_id: "GeneratedId",
     #         identifier: { # required
     #           type: "ANALYSIS", # required, accepts ANALYSIS, INCIDENT, METRIC, PARENT, ATTACHMENT, OTHER, AUTOMATION, INVOLVED_RESOURCE, TASK
     #           value: { # required
@@ -1706,6 +1771,13 @@ module Aws::SSMIncidents
     #         title: "RelatedItemTitleString",
     #       }
     #
+    # @!attribute [rw] generated_id
+    #   A unique ID for a `RelatedItem`.
+    #
+    #   Don't specify this parameter when you add a `RelatedItem` by using
+    #   the UpdateRelatedItems API action.
+    #   @return [String]
+    #
     # @!attribute [rw] identifier
     #   Details about the related item.
     #   @return [Types::ItemIdentifier]
@@ -1717,6 +1789,7 @@ module Aws::SSMIncidents
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-incidents-2018-05-10/RelatedItem AWS API Documentation
     #
     class RelatedItem < Struct.new(
+      :generated_id,
       :identifier,
       :title)
       SENSITIVE = []
@@ -1981,6 +2054,7 @@ module Aws::SSMIncidents
     #         impact: 1,
     #         related_items: [
     #           {
+    #             generated_id: "GeneratedId",
     #             identifier: { # required
     #               type: "ANALYSIS", # required, accepts ANALYSIS, INCIDENT, METRIC, PARENT, ATTACHMENT, OTHER, AUTOMATION, INVOLVED_RESOURCE, TASK
     #               value: { # required
@@ -2094,7 +2168,7 @@ module Aws::SSMIncidents
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags that you are adding to the response plan.
+    #   A list of tags to add to the response plan.
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-incidents-2018-05-10/TagResourceRequest AWS API Documentation
@@ -2143,6 +2217,10 @@ module Aws::SSMIncidents
     #   The ID of the timeline event.
     #   @return [String]
     #
+    # @!attribute [rw] event_references
+    #   A list of references in a `TimelineEvent`.
+    #   @return [Array<Types::EventReference>]
+    #
     # @!attribute [rw] event_time
     #   The time that the event occurred.
     #   @return [Time]
@@ -2166,6 +2244,7 @@ module Aws::SSMIncidents
     class TimelineEvent < Struct.new(
       :event_data,
       :event_id,
+      :event_references,
       :event_time,
       :event_type,
       :event_updated_time,
@@ -2234,7 +2313,7 @@ module Aws::SSMIncidents
     #   @return [String]
     #
     # @!attribute [rw] tag_keys
-    #   The name of the tag you're removing from the response plan.
+    #   The name of the tag to remove from the response plan.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-incidents-2018-05-10/UntagResourceRequest AWS API Documentation
@@ -2260,12 +2339,11 @@ module Aws::SSMIncidents
     #       }
     #
     # @!attribute [rw] arn
-    #   The Amazon Resource Name (ARN) of the replication set you're
-    #   updating.
+    #   The Amazon Resource Name (ARN) of the replication set to update.
     #   @return [String]
     #
     # @!attribute [rw] client_token
-    #   A token ensuring that the operation is called only once with the
+    #   A token that ensures that the operation is called only once with the
     #   specified details.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -2273,7 +2351,7 @@ module Aws::SSMIncidents
     #   @return [String]
     #
     # @!attribute [rw] deletion_protected
-    #   Details if deletion protection is enabled or disabled in your
+    #   Specifies if deletion protection is turned on or off in your
     #   account.
     #   @return [Boolean]
     #
@@ -2399,6 +2477,7 @@ module Aws::SSMIncidents
     #         incident_record_arn: "Arn", # required
     #         related_items_update: { # required
     #           item_to_add: {
+    #             generated_id: "GeneratedId",
     #             identifier: { # required
     #               type: "ANALYSIS", # required, accepts ANALYSIS, INCIDENT, METRIC, PARENT, ATTACHMENT, OTHER, AUTOMATION, INVOLVED_RESOURCE, TASK
     #               value: { # required
@@ -2509,7 +2588,7 @@ module Aws::SSMIncidents
     #   @return [String]
     #
     # @!attribute [rw] client_token
-    #   A token ensuring that the operation is called only once with the
+    #   A token that ensures that the operation is called only once with the
     #   specified details.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -2605,8 +2684,8 @@ module Aws::SSMIncidents
     #   @return [String]
     #
     # @!attribute [rw] engagements
-    #   The contacts and escalation plans that Incident Manager engages at
-    #   the start of the incident.
+    #   The Amazon Resource Name (ARN) for the contacts and escalation plans
+    #   that the response plan engages during an incident.
     #   @return [Array<String>]
     #
     # @!attribute [rw] incident_template_dedupe_string
@@ -2642,9 +2721,11 @@ module Aws::SSMIncidents
     #   @return [String]
     #
     # @!attribute [rw] incident_template_tags
-    #   Tags to apply to an incident when calling the `StartIncident` API
-    #   action. To call this action, you must also have permission to call
-    #   the `TagResource` API action for the incident record resource.
+    #   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. To call this action, you must also have
+    #   permission to call the `TagResource` API action for the incident
+    #   record resource.
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] incident_template_title
@@ -2682,6 +2763,12 @@ module Aws::SSMIncidents
     #         client_token: "ClientToken",
     #         event_data: "EventData",
     #         event_id: "UUID", # required
+    #         event_references: [
+    #           {
+    #             related_item_id: "GeneratedId",
+    #             resource: "Arn",
+    #           },
+    #         ],
     #         event_time: Time.now,
     #         event_type: "TimelineEventType",
     #         incident_record_arn: "Arn", # required
@@ -2704,6 +2791,21 @@ module Aws::SSMIncidents
     #   `ListTimelineEvents`.
     #   @return [String]
     #
+    # @!attribute [rw] event_references
+    #   Updates all existing references in a `TimelineEvent`. A reference
+    #   can be an Amazon Web Services resource involved in the incident or
+    #   in some way associated with it. When you specify a reference, you
+    #   enter the Amazon Resource Name (ARN) of the resource. You can also
+    #   specify a related item. As an example, you could specify the ARN of
+    #   an Amazon DynamoDB (DynamoDB) table. The table for this example is
+    #   the resource. You could also specify a Amazon CloudWatch metric for
+    #   that table. The metric is the 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 them and enters only new references.
+    #   @return [Array<Types::EventReference>]
+    #
     # @!attribute [rw] event_time
     #   The time that the event occurred.
     #   @return [Time]
@@ -2723,6 +2825,7 @@ module Aws::SSMIncidents
       :client_token,
       :event_data,
       :event_id,
+      :event_references,
       :event_time,
       :event_type,
       :incident_record_arn)

data/lib/aws-sdk-ssmincidents.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-ssmincidents/customizations'
 # @!group service
 module Aws::SSMIncidents
 
-  GEM_VERSION = '1.17.0'
+  GEM_VERSION = '1.19.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ssmincidents
 version: !ruby/object:Gem::Version
-  version: 1.17.0
+  version: 1.19.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-25 00:00:00.000000000 Z
+date: 2022-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core