aws-sdk-connectcases 1.18.0 → 1.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8fddee1708b2446c0b5ad50ca7e93445d1b4ce0c62563429a4cd8455c4496065
-  data.tar.gz: 1a75a65bea3da29abefa63e8b44fee5973570348c2be713acf3a46b0cef8c83a
+  metadata.gz: 5dacce0dcd1e1d7af519081c9d82db95ff470105ae2895818f66295b011abe76
+  data.tar.gz: 1400be916da96bae518c518f88e3573ecce08e60651aa63d92e3547efa1aafdc
 SHA512:
-  metadata.gz: 61d56a08b7c10f08eec1f6b3c8db7fd27d7bbd21df1fe388ec2f118dc63ba953035ebf251c17f369d3bb74f543e70ff2d5b101d5e57f39c97ad91333967a8a81
-  data.tar.gz: b29c96da83e10fd83b7de47f8e641ec2d485c05e06b7cfcba82f5d16e97d44a05a1a819e20f20c8f2921139faf7c237c314295349e06ab2ce87e9538caee2816
+  metadata.gz: a4dae8dd162609b53c410c4621498e4c51e2086be6bb2787b6f26461c34775a45a5a44d8d3f65f8e7e9caa201bd94cfc044422a8af017e0d23ad06583a083e41
+  data.tar.gz: 6b03afec0371fdbf8433b790e668a335e28ed83d4e5bbd0358578ecb827e0345b413171c79dc461da704e8c0393ca03bdcc6533520063656db6c6abf93e43322

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.19.0 (2024-01-22)
+------------------
+
+* Feature - This release adds the ability to view audit history on a case and introduces a new parameter, performedBy, for CreateCase and UpdateCase API's.
+
 1.18.0 (2023-12-15)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.18.0
+1.19.0

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

@@ -427,7 +427,7 @@ module Aws::ConnectCases
     #   resp.fields[0].namespace #=> String, one of "System", "Custom"
     #   resp.fields[0].tags #=> Hash
     #   resp.fields[0].tags["String"] #=> String
-    #   resp.fields[0].type #=> String, one of "Text", "Number", "Boolean", "DateTime", "SingleSelect", "Url"
+    #   resp.fields[0].type #=> String, one of "Text", "Number", "Boolean", "DateTime", "SingleSelect", "Url", "User"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connectcases-2022-10-03/BatchGetField AWS API Documentation
     #
@@ -484,13 +484,17 @@ module Aws::ConnectCases
       req.send_request(options)
     end
 
-    # Creates a case in the specified Cases domain. Case system and custom
-    # fields are taken as an array id/value pairs with a declared data
-    # types.
+    # <note markdown="1"> If you provide a value for `PerformedBy.UserArn` you must also have
+    # [connect:DescribeUser][1] permission on the User ARN resource that you
+    # provide
+    #
+    #  </note>
+    #
+    #      <p>Creates a case in the specified Cases domain. Case system and custom fields are taken as an array id/value pairs with a declared data types.</p> <p>The following fields are required when creating a case:</p> <ul> <li> <p> <code>customer_id</code> - You must provide the full customer profile ARN in this format: <code>arn:aws:profile:your_AWS_Region:your_AWS_account ID:domains/your_profiles_domain_name/profiles/profile_ID</code> </p> </li> <li> <p> <code>title</code> </p> </li> </ul>
+    #
     #
-    # The following fields are required when creating a case:
     #
-    #      <ul> <li> <p> <code>customer_id</code> - You must provide the full customer profile ARN in this format: <code>arn:aws:profile:your_AWS_Region:your_AWS_account ID:domains/your_profiles_domain_name/profiles/profile_ID</code> </p> </li> <li> <p> <code>title</code> </p> </li> </ul>
+    # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeUser.html
     #
     # @option params [String] :client_token
     #   A unique, case-sensitive identifier that you provide to ensure the
@@ -512,6 +516,9 @@ module Aws::ConnectCases
     #   An array of objects with field ID (matching ListFields/DescribeField)
     #   and value union data.
     #
+    # @option params [Types::UserUnion] :performed_by
+    #   Represents the identity of the person who performed the action.
+    #
     # @option params [required, String] :template_id
     #   A unique identifier of a template.
     #
@@ -534,9 +541,13 @@ module Aws::ConnectCases
     #           empty_value: {
     #           },
     #           string_value: "FieldValueUnionStringValueString",
+    #           user_arn_value: "String",
     #         },
     #       },
     #     ],
+    #     performed_by: {
+    #       user_arn: "UserArn",
+    #     },
     #     template_id: "TemplateId", # required
     #   })
     #
@@ -631,7 +642,7 @@ module Aws::ConnectCases
     #     description: "FieldDescription",
     #     domain_id: "DomainId", # required
     #     name: "FieldName", # required
-    #     type: "Text", # required, accepts Text, Number, Boolean, DateTime, SingleSelect, Url
+    #     type: "Text", # required, accepts Text, Number, Boolean, DateTime, SingleSelect, Url, User
     #   })
     #
     # @example Response structure
@@ -937,6 +948,7 @@ module Aws::ConnectCases
     #   resp.fields[0].value.boolean_value #=> Boolean
     #   resp.fields[0].value.double_value #=> Float
     #   resp.fields[0].value.string_value #=> String
+    #   resp.fields[0].value.user_arn_value #=> String
     #   resp.next_token #=> String
     #   resp.tags #=> Hash
     #   resp.tags["String"] #=> String
@@ -951,6 +963,70 @@ module Aws::ConnectCases
       req.send_request(options)
     end
 
+    # Returns the audit history about a specific case if it exists.
+    #
+    # @option params [required, String] :case_id
+    #   A unique identifier of the case.
+    #
+    # @option params [required, String] :domain_id
+    #   The unique identifier of the Cases domain.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of audit events to return. The current maximum
+    #   supported value is 25. This is also the default when no other value is
+    #   provided.
+    #
+    # @option params [String] :next_token
+    #   The token for the next set of results. Use the value returned in the
+    #   previous response in the next request to retrieve the next set of
+    #   results.
+    #
+    # @return [Types::GetCaseAuditEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetCaseAuditEventsResponse#audit_events #audit_events} => Array&lt;Types::AuditEvent&gt;
+    #   * {Types::GetCaseAuditEventsResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_case_audit_events({
+    #     case_id: "CaseId", # required
+    #     domain_id: "DomainId", # required
+    #     max_results: 1,
+    #     next_token: "NextToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.audit_events #=> Array
+    #   resp.audit_events[0].event_id #=> String
+    #   resp.audit_events[0].fields #=> Array
+    #   resp.audit_events[0].fields[0].event_field_id #=> String
+    #   resp.audit_events[0].fields[0].new_value.boolean_value #=> Boolean
+    #   resp.audit_events[0].fields[0].new_value.double_value #=> Float
+    #   resp.audit_events[0].fields[0].new_value.string_value #=> String
+    #   resp.audit_events[0].fields[0].new_value.user_arn_value #=> String
+    #   resp.audit_events[0].fields[0].old_value.boolean_value #=> Boolean
+    #   resp.audit_events[0].fields[0].old_value.double_value #=> Float
+    #   resp.audit_events[0].fields[0].old_value.string_value #=> String
+    #   resp.audit_events[0].fields[0].old_value.user_arn_value #=> String
+    #   resp.audit_events[0].performed_by.iam_principal_arn #=> String
+    #   resp.audit_events[0].performed_by.user.user_arn #=> String
+    #   resp.audit_events[0].performed_time #=> Time
+    #   resp.audit_events[0].related_item_type #=> String, one of "Contact", "Comment"
+    #   resp.audit_events[0].type #=> String, one of "Case.Created", "Case.Updated", "RelatedItem.Created"
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connectcases-2022-10-03/GetCaseAuditEvents AWS API Documentation
+    #
+    # @overload get_case_audit_events(params = {})
+    # @param [Hash] params ({})
+    def get_case_audit_events(params = {}, options = {})
+      req = build_request(:get_case_audit_events, params)
+      req.send_request(options)
+    end
+
     # Returns the case event publishing configuration.
     #
     # @option params [required, String] :domain_id
@@ -1295,7 +1371,7 @@ module Aws::ConnectCases
     #   resp.fields[0].field_id #=> String
     #   resp.fields[0].name #=> String
     #   resp.fields[0].namespace #=> String, one of "System", "Custom"
-    #   resp.fields[0].type #=> String, one of "Text", "Number", "Boolean", "DateTime", "SingleSelect", "Url"
+    #   resp.fields[0].type #=> String, one of "Text", "Number", "Boolean", "DateTime", "SingleSelect", "Url", "User"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connectcases-2022-10-03/ListFields AWS API Documentation
@@ -1546,6 +1622,7 @@ module Aws::ConnectCases
     #             empty_value: {
     #             },
     #             string_value: "FieldValueUnionStringValueString",
+    #             user_arn_value: "String",
     #           },
     #         },
     #         equal_to: {
@@ -1556,6 +1633,7 @@ module Aws::ConnectCases
     #             empty_value: {
     #             },
     #             string_value: "FieldValueUnionStringValueString",
+    #             user_arn_value: "String",
     #           },
     #         },
     #         greater_than: {
@@ -1566,6 +1644,7 @@ module Aws::ConnectCases
     #             empty_value: {
     #             },
     #             string_value: "FieldValueUnionStringValueString",
+    #             user_arn_value: "String",
     #           },
     #         },
     #         greater_than_or_equal_to: {
@@ -1576,6 +1655,7 @@ module Aws::ConnectCases
     #             empty_value: {
     #             },
     #             string_value: "FieldValueUnionStringValueString",
+    #             user_arn_value: "String",
     #           },
     #         },
     #         less_than: {
@@ -1586,6 +1666,7 @@ module Aws::ConnectCases
     #             empty_value: {
     #             },
     #             string_value: "FieldValueUnionStringValueString",
+    #             user_arn_value: "String",
     #           },
     #         },
     #         less_than_or_equal_to: {
@@ -1596,6 +1677,7 @@ module Aws::ConnectCases
     #             empty_value: {
     #             },
     #             string_value: "FieldValueUnionStringValueString",
+    #             user_arn_value: "String",
     #           },
     #         },
     #       },
@@ -1628,6 +1710,7 @@ module Aws::ConnectCases
     #   resp.cases[0].fields[0].value.boolean_value #=> Boolean
     #   resp.cases[0].fields[0].value.double_value #=> Float
     #   resp.cases[0].fields[0].value.string_value #=> String
+    #   resp.cases[0].fields[0].value.user_arn_value #=> String
     #   resp.cases[0].tags #=> Hash
     #   resp.cases[0].tags["String"] #=> String
     #   resp.cases[0].template_id #=> String
@@ -1773,12 +1856,17 @@ module Aws::ConnectCases
       req.send_request(options)
     end
 
-    # Updates the values of fields on a case. Fields to be updated are
-    # received as an array of id/value pairs identical to the `CreateCase`
-    # input .
+    # <note markdown="1"> If you provide a value for `PerformedBy.UserArn` you must also have
+    # [connect:DescribeUser][1] permission on the User ARN resource that you
+    # provide
+    #
+    #  </note>
+    #
+    #      <p>Updates the values of fields on a case. Fields to be updated are received as an array of id/value pairs identical to the <code>CreateCase</code> input .</p> <p>If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.</p>
+    #
     #
-    # If the action is successful, the service sends back an HTTP 200
-    # response with an empty HTTP body.
+    #
+    # [1]: https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeUser.html
     #
     # @option params [required, String] :case_id
     #   A unique identifier of the case.
@@ -1790,6 +1878,9 @@ module Aws::ConnectCases
     #   An array of objects with `fieldId` (matching ListFields/DescribeField)
     #   and value union data, structured identical to `CreateCase`.
     #
+    # @option params [Types::UserUnion] :performed_by
+    #   Represents the identity of the person who performed the action.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -1806,9 +1897,13 @@ module Aws::ConnectCases
     #           empty_value: {
     #           },
     #           string_value: "FieldValueUnionStringValueString",
+    #           user_arn_value: "String",
     #         },
     #       },
     #     ],
+    #     performed_by: {
+    #       user_arn: "UserArn",
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connectcases-2022-10-03/UpdateCase AWS API Documentation
@@ -2002,7 +2097,7 @@ module Aws::ConnectCases
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-connectcases'
-      context[:gem_version] = '1.18.0'
+      context[:gem_version] = '1.19.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -16,6 +16,16 @@ module Aws::ConnectCases
     AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException')
     Arn = Shapes::StringShape.new(name: 'Arn')
     AssociationTime = Shapes::TimestampShape.new(name: 'AssociationTime', timestampFormat: "iso8601")
+    AuditEvent = Shapes::StructureShape.new(name: 'AuditEvent')
+    AuditEventDateTime = Shapes::TimestampShape.new(name: 'AuditEventDateTime', timestampFormat: "iso8601")
+    AuditEventField = Shapes::StructureShape.new(name: 'AuditEventField')
+    AuditEventFieldId = Shapes::StringShape.new(name: 'AuditEventFieldId')
+    AuditEventFieldList = Shapes::ListShape.new(name: 'AuditEventFieldList')
+    AuditEventFieldValueUnion = Shapes::UnionShape.new(name: 'AuditEventFieldValueUnion')
+    AuditEventFieldValueUnionStringValueString = Shapes::StringShape.new(name: 'AuditEventFieldValueUnionStringValueString')
+    AuditEventId = Shapes::StringShape.new(name: 'AuditEventId')
+    AuditEventPerformedBy = Shapes::StructureShape.new(name: 'AuditEventPerformedBy')
+    AuditEventType = Shapes::StringShape.new(name: 'AuditEventType')
     BasicLayout = Shapes::StructureShape.new(name: 'BasicLayout')
     BatchGetFieldIdentifierList = Shapes::ListShape.new(name: 'BatchGetFieldIdentifierList')
     BatchGetFieldRequest = Shapes::StructureShape.new(name: 'BatchGetFieldRequest')
@@ -96,6 +106,10 @@ module Aws::ConnectCases
     FieldValue = Shapes::StructureShape.new(name: 'FieldValue')
     FieldValueUnion = Shapes::UnionShape.new(name: 'FieldValueUnion')
     FieldValueUnionStringValueString = Shapes::StringShape.new(name: 'FieldValueUnionStringValueString')
+    GetCaseAuditEventsRequest = Shapes::StructureShape.new(name: 'GetCaseAuditEventsRequest')
+    GetCaseAuditEventsRequestMaxResultsInteger = Shapes::IntegerShape.new(name: 'GetCaseAuditEventsRequestMaxResultsInteger')
+    GetCaseAuditEventsResponse = Shapes::StructureShape.new(name: 'GetCaseAuditEventsResponse')
+    GetCaseAuditEventsResponseAuditEventsList = Shapes::ListShape.new(name: 'GetCaseAuditEventsResponseAuditEventsList')
     GetCaseEventConfigurationRequest = Shapes::StructureShape.new(name: 'GetCaseEventConfigurationRequest')
     GetCaseEventConfigurationResponse = Shapes::StructureShape.new(name: 'GetCaseEventConfigurationResponse')
     GetCaseRequest = Shapes::StructureShape.new(name: 'GetCaseRequest')
@@ -109,6 +123,7 @@ module Aws::ConnectCases
     GetLayoutResponse = Shapes::StructureShape.new(name: 'GetLayoutResponse')
     GetTemplateRequest = Shapes::StructureShape.new(name: 'GetTemplateRequest')
     GetTemplateResponse = Shapes::StructureShape.new(name: 'GetTemplateResponse')
+    IamPrincipalArn = Shapes::StringShape.new(name: 'IamPrincipalArn')
     Integer = Shapes::IntegerShape.new(name: 'Integer')
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
     LayoutArn = Shapes::StringShape.new(name: 'LayoutArn')
@@ -204,6 +219,39 @@ module Aws::ConnectCases
     AccessDeniedException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
     AccessDeniedException.struct_class = Types::AccessDeniedException
 
+    AuditEvent.add_member(:event_id, Shapes::ShapeRef.new(shape: AuditEventId, required: true, location_name: "eventId"))
+    AuditEvent.add_member(:fields, Shapes::ShapeRef.new(shape: AuditEventFieldList, required: true, location_name: "fields"))
+    AuditEvent.add_member(:performed_by, Shapes::ShapeRef.new(shape: AuditEventPerformedBy, location_name: "performedBy"))
+    AuditEvent.add_member(:performed_time, Shapes::ShapeRef.new(shape: AuditEventDateTime, required: true, location_name: "performedTime"))
+    AuditEvent.add_member(:related_item_type, Shapes::ShapeRef.new(shape: RelatedItemType, location_name: "relatedItemType"))
+    AuditEvent.add_member(:type, Shapes::ShapeRef.new(shape: AuditEventType, required: true, location_name: "type"))
+    AuditEvent.struct_class = Types::AuditEvent
+
+    AuditEventField.add_member(:event_field_id, Shapes::ShapeRef.new(shape: AuditEventFieldId, required: true, location_name: "eventFieldId"))
+    AuditEventField.add_member(:new_value, Shapes::ShapeRef.new(shape: AuditEventFieldValueUnion, required: true, location_name: "newValue"))
+    AuditEventField.add_member(:old_value, Shapes::ShapeRef.new(shape: AuditEventFieldValueUnion, location_name: "oldValue"))
+    AuditEventField.struct_class = Types::AuditEventField
+
+    AuditEventFieldList.member = Shapes::ShapeRef.new(shape: AuditEventField)
+
+    AuditEventFieldValueUnion.add_member(:boolean_value, Shapes::ShapeRef.new(shape: Boolean, location_name: "booleanValue"))
+    AuditEventFieldValueUnion.add_member(:double_value, Shapes::ShapeRef.new(shape: Double, location_name: "doubleValue"))
+    AuditEventFieldValueUnion.add_member(:empty_value, Shapes::ShapeRef.new(shape: EmptyFieldValue, location_name: "emptyValue"))
+    AuditEventFieldValueUnion.add_member(:string_value, Shapes::ShapeRef.new(shape: AuditEventFieldValueUnionStringValueString, location_name: "stringValue"))
+    AuditEventFieldValueUnion.add_member(:user_arn_value, Shapes::ShapeRef.new(shape: String, location_name: "userArnValue"))
+    AuditEventFieldValueUnion.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    AuditEventFieldValueUnion.add_member_subclass(:boolean_value, Types::AuditEventFieldValueUnion::BooleanValue)
+    AuditEventFieldValueUnion.add_member_subclass(:double_value, Types::AuditEventFieldValueUnion::DoubleValue)
+    AuditEventFieldValueUnion.add_member_subclass(:empty_value, Types::AuditEventFieldValueUnion::EmptyValue)
+    AuditEventFieldValueUnion.add_member_subclass(:string_value, Types::AuditEventFieldValueUnion::StringValue)
+    AuditEventFieldValueUnion.add_member_subclass(:user_arn_value, Types::AuditEventFieldValueUnion::UserArnValue)
+    AuditEventFieldValueUnion.add_member_subclass(:unknown, Types::AuditEventFieldValueUnion::Unknown)
+    AuditEventFieldValueUnion.struct_class = Types::AuditEventFieldValueUnion
+
+    AuditEventPerformedBy.add_member(:iam_principal_arn, Shapes::ShapeRef.new(shape: IamPrincipalArn, required: true, location_name: "iamPrincipalArn"))
+    AuditEventPerformedBy.add_member(:user, Shapes::ShapeRef.new(shape: UserUnion, location_name: "user"))
+    AuditEventPerformedBy.struct_class = Types::AuditEventPerformedBy
+
     BasicLayout.add_member(:more_info, Shapes::ShapeRef.new(shape: LayoutSections, location_name: "moreInfo"))
     BasicLayout.add_member(:top_panel, Shapes::ShapeRef.new(shape: LayoutSections, location_name: "topPanel"))
     BasicLayout.struct_class = Types::BasicLayout
@@ -285,6 +333,7 @@ module Aws::ConnectCases
     CreateCaseRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: CreateCaseRequestClientTokenString, location_name: "clientToken", metadata: {"idempotencyToken"=>true}))
     CreateCaseRequest.add_member(:domain_id, Shapes::ShapeRef.new(shape: DomainId, required: true, location: "uri", location_name: "domainId"))
     CreateCaseRequest.add_member(:fields, Shapes::ShapeRef.new(shape: CreateCaseRequestFieldsList, required: true, location_name: "fields"))
+    CreateCaseRequest.add_member(:performed_by, Shapes::ShapeRef.new(shape: UserUnion, location_name: "performedBy"))
     CreateCaseRequest.add_member(:template_id, Shapes::ShapeRef.new(shape: TemplateId, required: true, location_name: "templateId"))
     CreateCaseRequest.struct_class = Types::CreateCaseRequest
 
@@ -426,14 +475,28 @@ module Aws::ConnectCases
     FieldValueUnion.add_member(:double_value, Shapes::ShapeRef.new(shape: Double, location_name: "doubleValue"))
     FieldValueUnion.add_member(:empty_value, Shapes::ShapeRef.new(shape: EmptyFieldValue, location_name: "emptyValue"))
     FieldValueUnion.add_member(:string_value, Shapes::ShapeRef.new(shape: FieldValueUnionStringValueString, location_name: "stringValue"))
+    FieldValueUnion.add_member(:user_arn_value, Shapes::ShapeRef.new(shape: String, location_name: "userArnValue"))
     FieldValueUnion.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
     FieldValueUnion.add_member_subclass(:boolean_value, Types::FieldValueUnion::BooleanValue)
     FieldValueUnion.add_member_subclass(:double_value, Types::FieldValueUnion::DoubleValue)
     FieldValueUnion.add_member_subclass(:empty_value, Types::FieldValueUnion::EmptyValue)
     FieldValueUnion.add_member_subclass(:string_value, Types::FieldValueUnion::StringValue)
+    FieldValueUnion.add_member_subclass(:user_arn_value, Types::FieldValueUnion::UserArnValue)
     FieldValueUnion.add_member_subclass(:unknown, Types::FieldValueUnion::Unknown)
     FieldValueUnion.struct_class = Types::FieldValueUnion
 
+    GetCaseAuditEventsRequest.add_member(:case_id, Shapes::ShapeRef.new(shape: CaseId, required: true, location: "uri", location_name: "caseId"))
+    GetCaseAuditEventsRequest.add_member(:domain_id, Shapes::ShapeRef.new(shape: DomainId, required: true, location: "uri", location_name: "domainId"))
+    GetCaseAuditEventsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: GetCaseAuditEventsRequestMaxResultsInteger, location_name: "maxResults"))
+    GetCaseAuditEventsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
+    GetCaseAuditEventsRequest.struct_class = Types::GetCaseAuditEventsRequest
+
+    GetCaseAuditEventsResponse.add_member(:audit_events, Shapes::ShapeRef.new(shape: GetCaseAuditEventsResponseAuditEventsList, required: true, location_name: "auditEvents"))
+    GetCaseAuditEventsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
+    GetCaseAuditEventsResponse.struct_class = Types::GetCaseAuditEventsResponse
+
+    GetCaseAuditEventsResponseAuditEventsList.member = Shapes::ShapeRef.new(shape: AuditEvent)
+
     GetCaseEventConfigurationRequest.add_member(:domain_id, Shapes::ShapeRef.new(shape: DomainId, required: true, location: "uri", location_name: "domainId"))
     GetCaseEventConfigurationRequest.struct_class = Types::GetCaseEventConfigurationRequest
 
@@ -728,6 +791,7 @@ module Aws::ConnectCases
     UpdateCaseRequest.add_member(:case_id, Shapes::ShapeRef.new(shape: CaseId, required: true, location: "uri", location_name: "caseId"))
     UpdateCaseRequest.add_member(:domain_id, Shapes::ShapeRef.new(shape: DomainId, required: true, location: "uri", location_name: "domainId"))
     UpdateCaseRequest.add_member(:fields, Shapes::ShapeRef.new(shape: UpdateCaseRequestFieldsList, required: true, location_name: "fields"))
+    UpdateCaseRequest.add_member(:performed_by, Shapes::ShapeRef.new(shape: UserUnion, location_name: "performedBy"))
     UpdateCaseRequest.struct_class = Types::UpdateCaseRequest
 
     UpdateCaseRequestFieldsList.member = Shapes::ShapeRef.new(shape: FieldValue)
@@ -937,6 +1001,25 @@ module Aws::ConnectCases
         )
       end)
 
+      api.add_operation(:get_case_audit_events, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetCaseAuditEvents"
+        o.http_method = "POST"
+        o.http_request_uri = "/domains/{domainId}/cases/{caseId}/audit-history"
+        o.input = Shapes::ShapeRef.new(shape: GetCaseAuditEventsRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetCaseAuditEventsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:get_case_event_configuration, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetCaseEventConfiguration"
         o.http_method = "POST"

data/lib/aws-sdk-connectcases/endpoints.rb

@@ -152,6 +152,20 @@ module Aws::ConnectCases
       end
     end
 
+    class GetCaseAuditEvents
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::ConnectCases::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class GetCaseEventConfiguration
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-connectcases/plugins/endpoints.rb

@@ -77,6 +77,8 @@ module Aws::ConnectCases
             Aws::ConnectCases::Endpoints::DeleteDomain.build(context)
           when :get_case
             Aws::ConnectCases::Endpoints::GetCase.build(context)
+          when :get_case_audit_events
+            Aws::ConnectCases::Endpoints::GetCaseAuditEvents.build(context)
           when :get_case_event_configuration
             Aws::ConnectCases::Endpoints::GetCaseEventConfiguration.build(context)
           when :get_domain

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

@@ -23,6 +23,144 @@ module Aws::ConnectCases
       include Aws::Structure
     end
 
+    # Represents the content of a particular audit event.
+    #
+    # @!attribute [rw] event_id
+    #   Unique identifier of a case audit history event.
+    #   @return [String]
+    #
+    # @!attribute [rw] fields
+    #   A list of Case Audit History event fields.
+    #   @return [Array<Types::AuditEventField>]
+    #
+    # @!attribute [rw] performed_by
+    #   Information of the user which performed the audit.
+    #   @return [Types::AuditEventPerformedBy]
+    #
+    # @!attribute [rw] performed_time
+    #   Time at which an Audit History event took place.
+    #   @return [Time]
+    #
+    # @!attribute [rw] related_item_type
+    #   The Type of the related item.
+    #   @return [String]
+    #
+    # @!attribute [rw] type
+    #   The Type of an audit history event.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connectcases-2022-10-03/AuditEvent AWS API Documentation
+    #
+    class AuditEvent < Struct.new(
+      :event_id,
+      :fields,
+      :performed_by,
+      :performed_time,
+      :related_item_type,
+      :type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Fields for audit event.
+    #
+    # @!attribute [rw] event_field_id
+    #   Unique identifier of field in an Audit History entry.
+    #   @return [String]
+    #
+    # @!attribute [rw] new_value
+    #   Union of potential field value types.
+    #   @return [Types::AuditEventFieldValueUnion]
+    #
+    # @!attribute [rw] old_value
+    #   Union of potential field value types.
+    #   @return [Types::AuditEventFieldValueUnion]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connectcases-2022-10-03/AuditEventField AWS API Documentation
+    #
+    class AuditEventField < Struct.new(
+      :event_field_id,
+      :new_value,
+      :old_value)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Object to store union of Field values.
+    #
+    # This data type is a UNION, so only one of the following members can be
+    # specified when used or returned.
+    #
+    # @note AuditEventFieldValueUnion is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of AuditEventFieldValueUnion corresponding to the set member.
+    #
+    # @!attribute [rw] boolean_value
+    #   Can be either null, or have a Boolean value type. Only one value can
+    #   be provided.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] double_value
+    #   Can be either null, or have a Double value type. Only one value can
+    #   be provided.
+    #   @return [Float]
+    #
+    # @!attribute [rw] empty_value
+    #   An empty value. You cannot set `EmptyFieldValue` on a field that is
+    #   required on a case template.
+    #
+    #   This structure will never have any data members. It signifies an
+    #   empty value on a case field.
+    #   @return [Types::EmptyFieldValue]
+    #
+    # @!attribute [rw] string_value
+    #   Can be either null, or have a String value type. Only one value can
+    #   be provided.
+    #   @return [String]
+    #
+    # @!attribute [rw] user_arn_value
+    #   Can be either null, or have a String value type formatted as an ARN.
+    #   Only one value can be provided.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connectcases-2022-10-03/AuditEventFieldValueUnion AWS API Documentation
+    #
+    class AuditEventFieldValueUnion < Struct.new(
+      :boolean_value,
+      :double_value,
+      :empty_value,
+      :string_value,
+      :user_arn_value,
+      :unknown)
+      SENSITIVE = []
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class BooleanValue < AuditEventFieldValueUnion; end
+      class DoubleValue < AuditEventFieldValueUnion; end
+      class EmptyValue < AuditEventFieldValueUnion; end
+      class StringValue < AuditEventFieldValueUnion; end
+      class UserArnValue < AuditEventFieldValueUnion; end
+      class Unknown < AuditEventFieldValueUnion; end
+    end
+
+    # Information of the user which performed the audit.
+    #
+    # @!attribute [rw] iam_principal_arn
+    #   Unique identifier of an IAM role.
+    #   @return [String]
+    #
+    # @!attribute [rw] user
+    #   Represents the identity of the person who performed the action.
+    #   @return [Types::UserUnion]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connectcases-2022-10-03/AuditEventPerformedBy AWS API Documentation
+    #
+    class AuditEventPerformedBy < Struct.new(
+      :iam_principal_arn,
+      :user)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Content specific to `BasicLayout` type. It configures fields in the
     # top panel and More Info tab of agent application.
     #
@@ -308,6 +446,10 @@ module Aws::ConnectCases
     #   ListFields/DescribeField) and value union data.
     #   @return [Array<Types::FieldValue>]
     #
+    # @!attribute [rw] performed_by
+    #   Represents the identity of the person who performed the action.
+    #   @return [Types::UserUnion]
+    #
     # @!attribute [rw] template_id
     #   A unique identifier of a template.
     #   @return [String]
@@ -318,6 +460,7 @@ module Aws::ConnectCases
       :client_token,
       :domain_id,
       :fields,
+      :performed_by,
       :template_id)
       SENSITIVE = []
       include Aws::Structure
@@ -886,6 +1029,11 @@ module Aws::ConnectCases
 
     # Object to store union of Field values.
     #
+    # <note markdown="1"> The `Summary` system field accepts 1500 characters while all other
+    # fields accept 500 characters.
+    #
+    #  </note>
+    #
     # @note FieldValueUnion is a union - when making an API calls you must set exactly one of the members.
     #
     # @note FieldValueUnion is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of FieldValueUnion corresponding to the set member.
@@ -908,6 +1056,10 @@ module Aws::ConnectCases
     #   String value type.
     #   @return [String]
     #
+    # @!attribute [rw] user_arn_value
+    #   Represents the user that performed the audit.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connectcases-2022-10-03/FieldValueUnion AWS API Documentation
     #
     class FieldValueUnion < Struct.new(
@@ -915,6 +1067,7 @@ module Aws::ConnectCases
       :double_value,
       :empty_value,
       :string_value,
+      :user_arn_value,
       :unknown)
       SENSITIVE = []
       include Aws::Structure
@@ -924,9 +1077,60 @@ module Aws::ConnectCases
       class DoubleValue < FieldValueUnion; end
       class EmptyValue < FieldValueUnion; end
       class StringValue < FieldValueUnion; end
+      class UserArnValue < FieldValueUnion; end
       class Unknown < FieldValueUnion; end
     end
 
+    # @!attribute [rw] case_id
+    #   A unique identifier of the case.
+    #   @return [String]
+    #
+    # @!attribute [rw] domain_id
+    #   The unique identifier of the Cases domain.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of audit events to return. The current maximum
+    #   supported value is 25. This is also the default when no other value
+    #   is provided.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The token for the next set of results. Use the value returned in the
+    #   previous response in the next request to retrieve the next set of
+    #   results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connectcases-2022-10-03/GetCaseAuditEventsRequest AWS API Documentation
+    #
+    class GetCaseAuditEventsRequest < Struct.new(
+      :case_id,
+      :domain_id,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] audit_events
+    #   A list of case audits where each represents a particular edit of the
+    #   case.
+    #   @return [Array<Types::AuditEvent>]
+    #
+    # @!attribute [rw] next_token
+    #   The token for the next set of results. This is null if there are no
+    #   more results to return.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/connectcases-2022-10-03/GetCaseAuditEventsResponse AWS API Documentation
+    #
+    class GetCaseAuditEventsResponse < Struct.new(
+      :audit_events,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] domain_id
     #   The unique identifier of the Cases domain.
     #   @return [String]
@@ -2114,12 +2318,17 @@ module Aws::ConnectCases
     #   to `CreateCase`.
     #   @return [Array<Types::FieldValue>]
     #
+    # @!attribute [rw] performed_by
+    #   Represents the identity of the person who performed the action.
+    #   @return [Types::UserUnion]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/connectcases-2022-10-03/UpdateCaseRequest AWS API Documentation
     #
     class UpdateCaseRequest < Struct.new(
       :case_id,
       :domain_id,
-      :fields)
+      :fields,
+      :performed_by)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-connectcases.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-connectcases/customizations'
 # @!group service
 module Aws::ConnectCases
 
-  GEM_VERSION = '1.18.0'
+  GEM_VERSION = '1.19.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-connectcases
 version: !ruby/object:Gem::Version
-  version: 1.18.0
+  version: 1.19.0
 platform: ruby
 authors:
 - Amazon Web Services
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-15 00:00:00.000000000 Z
+date: 2024-01-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -72,7 +72,7 @@ licenses:
 metadata:
   source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-connectcases
   changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-connectcases/CHANGELOG.md
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -87,8 +87,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key: 
+rubygems_version: 3.4.10
+signing_key:
 specification_version: 4
 summary: AWS SDK for Ruby - ConnectCases
 test_files: []