aws-sdk-transcribeservice 1.126.0 → 1.127.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84d5d756a1ab931c0b9ef8a7851da141fd7e98c5f722622ba6feb0115db5f286
-  data.tar.gz: 12bc05abe3d48cc4a5571f93426d30915cca5414787782dbe592a9da0555f39f
+  metadata.gz: 212c1b14f98e639d20fd3be11e7abec5df4d626870d72d9d4184ab247e6d9736
+  data.tar.gz: 5cde5e4ea03afbab9da47e721d8a6e9b42f10480536155d541cafbee88292d48
 SHA512:
-  metadata.gz: 5f194b2d8583540bd52b87da48c463e3972ee5244c0990c2549df201085935686c3223e319acc32cfd80e928726af95a1d5ef5aa975aeb3c884ad971d87b5712
-  data.tar.gz: 391e48ff84fa65bff7f14646e5d25114998a19e08b23fb3daed0103b7b4f2df0f00d91a916f3aeed6af785862c622f222c33634e0bb7dbad1eb346fe66bd6795
+  metadata.gz: 22cbbb198f9342e430e2fd44262eb8bc10e76463f7991d2df28977b2bd3194ad77f5a5f162a4bbe744c5b7392fb3cb5b5750bfe6b2554692470963b32d9e9b2e
+  data.tar.gz: e46687fbb7f1217524b5871f4234d44d7bf09d80d8bdfab20282f08a87841209a8aed4094f7a2964aa6d6975307b449efd339975438766f0065e9acb9bda04ec

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.127.0 (2025-08-12)
+------------------
+
+* Feature - AWS HealthScribe now supports specifying preferred patient pronouns through the MedicalScribeContext parameter for use in the generated clinical notes.
+
 1.126.0 (2025-08-08)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.126.0
+1.127.0

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

@@ -1700,6 +1700,7 @@ module Aws::TranscribeService
     #   resp.medical_scribe_job.channel_definitions #=> Array
     #   resp.medical_scribe_job.channel_definitions[0].channel_id #=> Integer
     #   resp.medical_scribe_job.channel_definitions[0].participant_role #=> String, one of "PATIENT", "CLINICIAN"
+    #   resp.medical_scribe_job.medical_scribe_context_provided #=> Boolean
     #   resp.medical_scribe_job.tags #=> Array
     #   resp.medical_scribe_job.tags[0].key #=> String
     #   resp.medical_scribe_job.tags[0].value #=> String
@@ -2789,24 +2790,42 @@ module Aws::TranscribeService
     #   access your transcript.
     #
     # @option params [String] :output_encryption_kms_key_id
-    #   The Amazon Resource Name (ARN) of a KMS key that you want to use to
-    #   encrypt your Call Analytics output.
+    #   The KMS key you want to use to encrypt your Call Analytics output.
     #
-    #   KMS key ARNs have the format
-    #   `arn:partition:kms:region:account:key/key-id`. For example:
-    #   `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
-    #   For more information, see [ KMS key ARNs][1].
+    #   If using a key located in the **current** Amazon Web Services account,
+    #   you can specify your KMS key in one of four ways:
     #
-    #   If you do not specify an encryption key, your output is encrypted with
-    #   the default Amazon S3 key (SSE-S3).
+    #   1.  Use the KMS key ID itself. For example,
+    #       `1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   2.  Use an alias for the KMS key ID. For example,
+    #       `alias/ExampleAlias`.
+    #
+    #   3.  Use the Amazon Resource Name (ARN) for the KMS key ID. For
+    #       example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   4.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
-    #   Note that the role making the request and the role specified in the
-    #   `DataAccessRoleArn` request parameter (if present) must have
-    #   permission to use the specified KMS key.
+    #   If using a key located in a **different** Amazon Web Services account
+    #   than the current Amazon Web Services account, you can specify your KMS
+    #   key in one of two ways:
     #
+    #   1.  Use the ARN for the KMS key ID. For example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
     #
+    #   2.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
-    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id-key-ARN
+    #   If you do not specify an encryption key, your output is encrypted with
+    #   the default Amazon S3 key (SSE-S3).
+    #
+    #   If you specify a KMS key to encrypt your output, you must also specify
+    #   an output location using the `OutputLocation` parameter.
+    #
+    #   Note that the role making the request must have permission to use the
+    #   specified KMS key.
     #
     # @option params [String] :data_access_role_arn
     #   The Amazon Resource Name (ARN) of an IAM role that has permissions to
@@ -2983,7 +3002,7 @@ module Aws::TranscribeService
     # * `OutputBucketName`: The Amazon S3 bucket where you want your output
     #   files stored.
     #
-    # * `Settings`: A `MedicalScribeSettings` obect that must set exactly
+    # * `Settings`: A `MedicalScribeSettings` object that must set exactly
     #   one of `ShowSpeakerLabels` or `ChannelIdentification` to true. If
     #   `ShowSpeakerLabels` is true, `MaxSpeakerLabels` must also be set.
     #
@@ -3031,24 +3050,39 @@ module Aws::TranscribeService
     #   [2]: https://docs.aws.amazon.com/transcribe/latest/dg/security_iam_id-based-policy-examples.html#auth-role-iam-user
     #
     # @option params [String] :output_encryption_kms_key_id
-    #   The Amazon Resource Name (ARN) of a KMS key that you want to use to
-    #   encrypt your Medical Scribe output.
+    #   The KMS key you want to use to encrypt your Medical Scribe output.
     #
-    #   KMS key ARNs have the format
-    #   `arn:partition:kms:region:account:key/key-id`. For example:
-    #   `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
-    #   For more information, see [ KMS key ARNs][1].
+    #   If using a key located in the **current** Amazon Web Services account,
+    #   you can specify your KMS key in one of four ways:
     #
-    #   If you do not specify an encryption key, your output is encrypted with
-    #   the default Amazon S3 key (SSE-S3).
+    #   1.  Use the KMS key ID itself. For example,
+    #       `1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   2.  Use an alias for the KMS key ID. For example,
+    #       `alias/ExampleAlias`.
+    #
+    #   3.  Use the Amazon Resource Name (ARN) for the KMS key ID. For
+    #       example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   4.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
+    #
+    #   If using a key located in a **different** Amazon Web Services account
+    #   than the current Amazon Web Services account, you can specify your KMS
+    #   key in one of two ways:
     #
-    #   Note that the role making the request and the role specified in the
-    #   `DataAccessRoleArn` request parameter (if present) must have
-    #   permission to use the specified KMS key.
+    #   1.  Use the ARN for the KMS key ID. For example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
     #
+    #   2.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
+    #   If you do not specify an encryption key, your output is encrypted with
+    #   the default Amazon S3 key (SSE-S3).
     #
-    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id-key-ARN
+    #   Note that the role specified in the `DataAccessRoleArn` request
+    #   parameter must have permission to use the specified KMS key.
     #
     # @option params [Hash<String,String>] :kms_encryption_context
     #   A map of plain text, non-secret key:value pairs, known as encryption
@@ -3102,7 +3136,7 @@ module Aws::TranscribeService
     #
     # @option params [Array<Types::Tag>] :tags
     #   Adds one or more custom tags, each in the form of a key:value pair, to
-    #   the Medica Scribe job.
+    #   the Medical Scribe job.
     #
     #   To learn more about using tags with Amazon Transcribe, refer to
     #   [Tagging resources][1].
@@ -3111,6 +3145,11 @@ module Aws::TranscribeService
     #
     #   [1]: https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html
     #
+    # @option params [Types::MedicalScribeContext] :medical_scribe_context
+    #   The `MedicalScribeContext` object that contains contextual information
+    #   which is used during clinical note generation to add relevant context
+    #   to the note.
+    #
     # @return [Types::StartMedicalScribeJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartMedicalScribeJobResponse#medical_scribe_job #medical_scribe_job} => Types::MedicalScribeJob
@@ -3152,6 +3191,11 @@ module Aws::TranscribeService
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     medical_scribe_context: {
+    #       patient_context: {
+    #         pronouns: "HE_HIM", # accepts HE_HIM, SHE_HER, THEY_THEM
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -3178,6 +3222,7 @@ module Aws::TranscribeService
     #   resp.medical_scribe_job.channel_definitions #=> Array
     #   resp.medical_scribe_job.channel_definitions[0].channel_id #=> Integer
     #   resp.medical_scribe_job.channel_definitions[0].participant_role #=> String, one of "PATIENT", "CLINICIAN"
+    #   resp.medical_scribe_job.medical_scribe_context_provided #=> Boolean
     #   resp.medical_scribe_job.tags #=> Array
     #   resp.medical_scribe_job.tags[0].key #=> String
     #   resp.medical_scribe_job.tags[0].value #=> String
@@ -3337,24 +3382,43 @@ module Aws::TranscribeService
     #   doesn't exist, one is created for you.
     #
     # @option params [String] :output_encryption_kms_key_id
-    #   The Amazon Resource Name (ARN) of a KMS key that you want to use to
-    #   encrypt your medical transcription output.
+    #   The KMS key you want to use to encrypt your medical transcription
+    #   output.
     #
-    #   KMS key ARNs have the format
-    #   `arn:partition:kms:region:account:key/key-id`. For example:
-    #   `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
-    #   For more information, see [ KMS key ARNs][1].
+    #   If using a key located in the **current** Amazon Web Services account,
+    #   you can specify your KMS key in one of four ways:
     #
-    #   If you do not specify an encryption key, your output is encrypted with
-    #   the default Amazon S3 key (SSE-S3).
+    #   1.  Use the KMS key ID itself. For example,
+    #       `1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   2.  Use an alias for the KMS key ID. For example,
+    #       `alias/ExampleAlias`.
+    #
+    #   3.  Use the Amazon Resource Name (ARN) for the KMS key ID. For
+    #       example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
     #
-    #   Note that the role making the request and the role specified in the
-    #   `DataAccessRoleArn` request parameter (if present) must have
-    #   permission to use the specified KMS key.
+    #   4.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
+    #   If using a key located in a **different** Amazon Web Services account
+    #   than the current Amazon Web Services account, you can specify your KMS
+    #   key in one of two ways:
+    #
+    #   1.  Use the ARN for the KMS key ID. For example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   2.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
+    #
+    #   If you do not specify an encryption key, your output is encrypted with
+    #   the default Amazon S3 key (SSE-S3).
     #
+    #   If you specify a KMS key to encrypt your output, you must also specify
+    #   an output location using the `OutputLocation` parameter.
     #
-    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id-key-ARN
+    #   Note that the role making the request must have permission to use the
+    #   specified KMS key.
     #
     # @option params [Hash<String,String>] :kms_encryption_context
     #   A map of plain text, non-secret key:value pairs, known as encryption
@@ -3637,24 +3701,42 @@ module Aws::TranscribeService
     #   doesn't exist, one is created for you.
     #
     # @option params [String] :output_encryption_kms_key_id
-    #   The Amazon Resource Name (ARN) of a KMS key that you want to use to
-    #   encrypt your transcription output.
+    #   The KMS key you want to use to encrypt your transcription output.
     #
-    #   KMS key ARNs have the format
-    #   `arn:partition:kms:region:account:key/key-id`. For example:
-    #   `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
-    #   For more information, see [ KMS key ARNs][1].
+    #   If using a key located in the **current** Amazon Web Services account,
+    #   you can specify your KMS key in one of four ways:
     #
-    #   If you do not specify an encryption key, your output is encrypted with
-    #   the default Amazon S3 key (SSE-S3).
+    #   1.  Use the KMS key ID itself. For example,
+    #       `1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   2.  Use an alias for the KMS key ID. For example,
+    #       `alias/ExampleAlias`.
+    #
+    #   3.  Use the Amazon Resource Name (ARN) for the KMS key ID. For
+    #       example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   4.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
-    #   Note that the role making the request and the role specified in the
-    #   `DataAccessRoleArn` request parameter (if present) must have
-    #   permission to use the specified KMS key.
+    #   If using a key located in a **different** Amazon Web Services account
+    #   than the current Amazon Web Services account, you can specify your KMS
+    #   key in one of two ways:
     #
+    #   1.  Use the ARN for the KMS key ID. For example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   2.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
+    #
+    #   If you do not specify an encryption key, your output is encrypted with
+    #   the default Amazon S3 key (SSE-S3).
     #
+    #   If you specify a KMS key to encrypt your output, you must also specify
+    #   an output location using the `OutputLocation` parameter.
     #
-    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id-key-ARN
+    #   Note that the role making the request must have permission to use the
+    #   specified KMS key.
     #
     # @option params [Hash<String,String>] :kms_encryption_context
     #   A map of plain text, non-secret key:value pairs, known as encryption
@@ -4502,7 +4584,7 @@ module Aws::TranscribeService
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-transcribeservice'
-      context[:gem_version] = '1.126.0'
+      context[:gem_version] = '1.127.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -129,6 +129,7 @@ module Aws::TranscribeService
     MedicalScribeChannelDefinition = Shapes::StructureShape.new(name: 'MedicalScribeChannelDefinition')
     MedicalScribeChannelDefinitions = Shapes::ListShape.new(name: 'MedicalScribeChannelDefinitions')
     MedicalScribeChannelId = Shapes::IntegerShape.new(name: 'MedicalScribeChannelId')
+    MedicalScribeContext = Shapes::StructureShape.new(name: 'MedicalScribeContext')
     MedicalScribeJob = Shapes::StructureShape.new(name: 'MedicalScribeJob')
     MedicalScribeJobStatus = Shapes::StringShape.new(name: 'MedicalScribeJobStatus')
     MedicalScribeJobSummaries = Shapes::ListShape.new(name: 'MedicalScribeJobSummaries')
@@ -137,6 +138,7 @@ module Aws::TranscribeService
     MedicalScribeNoteTemplate = Shapes::StringShape.new(name: 'MedicalScribeNoteTemplate')
     MedicalScribeOutput = Shapes::StructureShape.new(name: 'MedicalScribeOutput')
     MedicalScribeParticipantRole = Shapes::StringShape.new(name: 'MedicalScribeParticipantRole')
+    MedicalScribePatientContext = Shapes::StructureShape.new(name: 'MedicalScribePatientContext')
     MedicalScribeSettings = Shapes::StructureShape.new(name: 'MedicalScribeSettings')
     MedicalTranscript = Shapes::StructureShape.new(name: 'MedicalTranscript')
     MedicalTranscriptionJob = Shapes::StructureShape.new(name: 'MedicalTranscriptionJob')
@@ -160,6 +162,7 @@ module Aws::TranscribeService
     Phrases = Shapes::ListShape.new(name: 'Phrases')
     PiiEntityType = Shapes::StringShape.new(name: 'PiiEntityType')
     PiiEntityTypes = Shapes::ListShape.new(name: 'PiiEntityTypes')
+    Pronouns = Shapes::StringShape.new(name: 'Pronouns')
     RedactionOutput = Shapes::StringShape.new(name: 'RedactionOutput')
     RedactionType = Shapes::StringShape.new(name: 'RedactionType')
     RelativeTimeRange = Shapes::StructureShape.new(name: 'RelativeTimeRange')
@@ -642,6 +645,9 @@ module Aws::TranscribeService
 
     MedicalScribeChannelDefinitions.member = Shapes::ShapeRef.new(shape: MedicalScribeChannelDefinition)
 
+    MedicalScribeContext.add_member(:patient_context, Shapes::ShapeRef.new(shape: MedicalScribePatientContext, location_name: "PatientContext"))
+    MedicalScribeContext.struct_class = Types::MedicalScribeContext
+
     MedicalScribeJob.add_member(:medical_scribe_job_name, Shapes::ShapeRef.new(shape: TranscriptionJobName, location_name: "MedicalScribeJobName"))
     MedicalScribeJob.add_member(:medical_scribe_job_status, Shapes::ShapeRef.new(shape: MedicalScribeJobStatus, location_name: "MedicalScribeJobStatus"))
     MedicalScribeJob.add_member(:language_code, Shapes::ShapeRef.new(shape: MedicalScribeLanguageCode, location_name: "LanguageCode"))
@@ -654,6 +660,7 @@ module Aws::TranscribeService
     MedicalScribeJob.add_member(:settings, Shapes::ShapeRef.new(shape: MedicalScribeSettings, location_name: "Settings"))
     MedicalScribeJob.add_member(:data_access_role_arn, Shapes::ShapeRef.new(shape: DataAccessRoleArn, location_name: "DataAccessRoleArn"))
     MedicalScribeJob.add_member(:channel_definitions, Shapes::ShapeRef.new(shape: MedicalScribeChannelDefinitions, location_name: "ChannelDefinitions"))
+    MedicalScribeJob.add_member(:medical_scribe_context_provided, Shapes::ShapeRef.new(shape: Boolean, location_name: "MedicalScribeContextProvided"))
     MedicalScribeJob.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     MedicalScribeJob.struct_class = Types::MedicalScribeJob
 
@@ -672,6 +679,9 @@ module Aws::TranscribeService
     MedicalScribeOutput.add_member(:clinical_document_uri, Shapes::ShapeRef.new(shape: Uri, required: true, location_name: "ClinicalDocumentUri"))
     MedicalScribeOutput.struct_class = Types::MedicalScribeOutput
 
+    MedicalScribePatientContext.add_member(:pronouns, Shapes::ShapeRef.new(shape: Pronouns, location_name: "Pronouns"))
+    MedicalScribePatientContext.struct_class = Types::MedicalScribePatientContext
+
     MedicalScribeSettings.add_member(:show_speaker_labels, Shapes::ShapeRef.new(shape: Boolean, location_name: "ShowSpeakerLabels"))
     MedicalScribeSettings.add_member(:max_speaker_labels, Shapes::ShapeRef.new(shape: MaxSpeakers, location_name: "MaxSpeakerLabels"))
     MedicalScribeSettings.add_member(:channel_identification, Shapes::ShapeRef.new(shape: Boolean, location_name: "ChannelIdentification"))
@@ -804,6 +814,7 @@ module Aws::TranscribeService
     StartMedicalScribeJobRequest.add_member(:settings, Shapes::ShapeRef.new(shape: MedicalScribeSettings, required: true, location_name: "Settings"))
     StartMedicalScribeJobRequest.add_member(:channel_definitions, Shapes::ShapeRef.new(shape: MedicalScribeChannelDefinitions, location_name: "ChannelDefinitions"))
     StartMedicalScribeJobRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
+    StartMedicalScribeJobRequest.add_member(:medical_scribe_context, Shapes::ShapeRef.new(shape: MedicalScribeContext, location_name: "MedicalScribeContext"))
     StartMedicalScribeJobRequest.struct_class = Types::StartMedicalScribeJobRequest
 
     StartMedicalScribeJobResponse.add_member(:medical_scribe_job, Shapes::ShapeRef.new(shape: MedicalScribeJob, location_name: "MedicalScribeJob"))

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

@@ -2824,6 +2824,21 @@ module Aws::TranscribeService
       include Aws::Structure
     end
 
+    # The `MedicalScribeContext` object that contains contextual information
+    # used to generate customized clinical notes.
+    #
+    # @!attribute [rw] patient_context
+    #   Contains patient-specific information.
+    #   @return [Types::MedicalScribePatientContext]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/MedicalScribeContext AWS API Documentation
+    #
+    class MedicalScribeContext < Struct.new(
+      :patient_context)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Provides detailed information about a Medical Scribe job.
     #
     # To view the status of the specified Medical Scribe job, check the
@@ -2951,9 +2966,14 @@ module Aws::TranscribeService
     #   speaking).
     #   @return [Array<Types::MedicalScribeChannelDefinition>]
     #
+    # @!attribute [rw] medical_scribe_context_provided
+    #   Indicates whether the `MedicalScribeContext` object was provided
+    #   when the Medical Scribe job was started.
+    #   @return [Boolean]
+    #
     # @!attribute [rw] tags
     #   Adds one or more custom tags, each in the form of a key:value pair,
-    #   to the Medica Scribe job.
+    #   to the Medical Scribe job.
     #
     #   To learn more about using tags with Amazon Transcribe, refer to
     #   [Tagging resources][1].
@@ -2978,6 +2998,7 @@ module Aws::TranscribeService
       :settings,
       :data_access_role_arn,
       :channel_definitions,
+      :medical_scribe_context_provided,
       :tags)
       SENSITIVE = []
       include Aws::Structure
@@ -3076,6 +3097,22 @@ module Aws::TranscribeService
       include Aws::Structure
     end
 
+    # Contains patient-specific information used to customize the clinical
+    # note generation.
+    #
+    # @!attribute [rw] pronouns
+    #   The patient's preferred pronouns that the user wants to provide as
+    #   a context for clinical note generation.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/MedicalScribePatientContext AWS API Documentation
+    #
+    class MedicalScribePatientContext < Struct.new(
+      :pronouns)
+      SENSITIVE = [:pronouns]
+      include Aws::Structure
+    end
+
     # Makes it possible to control how your Medical Scribe job is processed
     # using a `MedicalScribeSettings` object. Specify
     # `ChannelIdentification` if `ChannelDefinitions` are set. Enabled
@@ -4022,24 +4059,42 @@ module Aws::TranscribeService
     #   @return [String]
     #
     # @!attribute [rw] output_encryption_kms_key_id
-    #   The Amazon Resource Name (ARN) of a KMS key that you want to use to
-    #   encrypt your Call Analytics output.
+    #   The KMS key you want to use to encrypt your Call Analytics output.
     #
-    #   KMS key ARNs have the format
-    #   `arn:partition:kms:region:account:key/key-id`. For example:
-    #   `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
-    #   For more information, see [ KMS key ARNs][1].
+    #   If using a key located in the **current** Amazon Web Services
+    #   account, you can specify your KMS key in one of four ways:
     #
-    #   If you do not specify an encryption key, your output is encrypted
-    #   with the default Amazon S3 key (SSE-S3).
+    #   1.  Use the KMS key ID itself. For example,
+    #       `1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   2.  Use an alias for the KMS key ID. For example,
+    #       `alias/ExampleAlias`.
+    #
+    #   3.  Use the Amazon Resource Name (ARN) for the KMS key ID. For
+    #       example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   4.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
-    #   Note that the role making the request and the role specified in the
-    #   `DataAccessRoleArn` request parameter (if present) must have
-    #   permission to use the specified KMS key.
+    #   If using a key located in a **different** Amazon Web Services
+    #   account than the current Amazon Web Services account, you can
+    #   specify your KMS key in one of two ways:
     #
+    #   1.  Use the ARN for the KMS key ID. For example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
     #
+    #   2.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
-    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id-key-ARN
+    #   If you do not specify an encryption key, your output is encrypted
+    #   with the default Amazon S3 key (SSE-S3).
+    #
+    #   If you specify a KMS key to encrypt your output, you must also
+    #   specify an output location using the `OutputLocation` parameter.
+    #
+    #   Note that the role making the request must have permission to use
+    #   the specified KMS key.
     #   @return [String]
     #
     # @!attribute [rw] data_access_role_arn
@@ -4154,24 +4209,39 @@ module Aws::TranscribeService
     #   @return [String]
     #
     # @!attribute [rw] output_encryption_kms_key_id
-    #   The Amazon Resource Name (ARN) of a KMS key that you want to use to
-    #   encrypt your Medical Scribe output.
+    #   The KMS key you want to use to encrypt your Medical Scribe output.
     #
-    #   KMS key ARNs have the format
-    #   `arn:partition:kms:region:account:key/key-id`. For example:
-    #   `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
-    #   For more information, see [ KMS key ARNs][1].
+    #   If using a key located in the **current** Amazon Web Services
+    #   account, you can specify your KMS key in one of four ways:
     #
-    #   If you do not specify an encryption key, your output is encrypted
-    #   with the default Amazon S3 key (SSE-S3).
+    #   1.  Use the KMS key ID itself. For example,
+    #       `1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   2.  Use an alias for the KMS key ID. For example,
+    #       `alias/ExampleAlias`.
     #
-    #   Note that the role making the request and the role specified in the
-    #   `DataAccessRoleArn` request parameter (if present) must have
-    #   permission to use the specified KMS key.
+    #   3.  Use the Amazon Resource Name (ARN) for the KMS key ID. For
+    #       example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
     #
+    #   4.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
+    #   If using a key located in a **different** Amazon Web Services
+    #   account than the current Amazon Web Services account, you can
+    #   specify your KMS key in one of two ways:
     #
-    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id-key-ARN
+    #   1.  Use the ARN for the KMS key ID. For example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   2.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
+    #
+    #   If you do not specify an encryption key, your output is encrypted
+    #   with the default Amazon S3 key (SSE-S3).
+    #
+    #   Note that the role specified in the `DataAccessRoleArn` request
+    #   parameter must have permission to use the specified KMS key.
     #   @return [String]
     #
     # @!attribute [rw] kms_encryption_context
@@ -4232,7 +4302,7 @@ module Aws::TranscribeService
     #
     # @!attribute [rw] tags
     #   Adds one or more custom tags, each in the form of a key:value pair,
-    #   to the Medica Scribe job.
+    #   to the Medical Scribe job.
     #
     #   To learn more about using tags with Amazon Transcribe, refer to
     #   [Tagging resources][1].
@@ -4242,6 +4312,12 @@ module Aws::TranscribeService
     #   [1]: https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] medical_scribe_context
+    #   The `MedicalScribeContext` object that contains contextual
+    #   information which is used during clinical note generation to add
+    #   relevant context to the note.
+    #   @return [Types::MedicalScribeContext]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/StartMedicalScribeJobRequest AWS API Documentation
     #
     class StartMedicalScribeJobRequest < Struct.new(
@@ -4253,7 +4329,8 @@ module Aws::TranscribeService
       :data_access_role_arn,
       :settings,
       :channel_definitions,
-      :tags)
+      :tags,
+      :medical_scribe_context)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4381,24 +4458,43 @@ module Aws::TranscribeService
     #   @return [String]
     #
     # @!attribute [rw] output_encryption_kms_key_id
-    #   The Amazon Resource Name (ARN) of a KMS key that you want to use to
-    #   encrypt your medical transcription output.
+    #   The KMS key you want to use to encrypt your medical transcription
+    #   output.
     #
-    #   KMS key ARNs have the format
-    #   `arn:partition:kms:region:account:key/key-id`. For example:
-    #   `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
-    #   For more information, see [ KMS key ARNs][1].
+    #   If using a key located in the **current** Amazon Web Services
+    #   account, you can specify your KMS key in one of four ways:
     #
-    #   If you do not specify an encryption key, your output is encrypted
-    #   with the default Amazon S3 key (SSE-S3).
+    #   1.  Use the KMS key ID itself. For example,
+    #       `1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   2.  Use an alias for the KMS key ID. For example,
+    #       `alias/ExampleAlias`.
+    #
+    #   3.  Use the Amazon Resource Name (ARN) for the KMS key ID. For
+    #       example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   4.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
-    #   Note that the role making the request and the role specified in the
-    #   `DataAccessRoleArn` request parameter (if present) must have
-    #   permission to use the specified KMS key.
+    #   If using a key located in a **different** Amazon Web Services
+    #   account than the current Amazon Web Services account, you can
+    #   specify your KMS key in one of two ways:
     #
+    #   1.  Use the ARN for the KMS key ID. For example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
     #
+    #   2.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
-    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id-key-ARN
+    #   If you do not specify an encryption key, your output is encrypted
+    #   with the default Amazon S3 key (SSE-S3).
+    #
+    #   If you specify a KMS key to encrypt your output, you must also
+    #   specify an output location using the `OutputLocation` parameter.
+    #
+    #   Note that the role making the request must have permission to use
+    #   the specified KMS key.
     #   @return [String]
     #
     # @!attribute [rw] kms_encryption_context
@@ -4622,24 +4718,42 @@ module Aws::TranscribeService
     #   @return [String]
     #
     # @!attribute [rw] output_encryption_kms_key_id
-    #   The Amazon Resource Name (ARN) of a KMS key that you want to use to
-    #   encrypt your transcription output.
+    #   The KMS key you want to use to encrypt your transcription output.
     #
-    #   KMS key ARNs have the format
-    #   `arn:partition:kms:region:account:key/key-id`. For example:
-    #   `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
-    #   For more information, see [ KMS key ARNs][1].
+    #   If using a key located in the **current** Amazon Web Services
+    #   account, you can specify your KMS key in one of four ways:
     #
-    #   If you do not specify an encryption key, your output is encrypted
-    #   with the default Amazon S3 key (SSE-S3).
+    #   1.  Use the KMS key ID itself. For example,
+    #       `1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   2.  Use an alias for the KMS key ID. For example,
+    #       `alias/ExampleAlias`.
     #
-    #   Note that the role making the request and the role specified in the
-    #   `DataAccessRoleArn` request parameter (if present) must have
-    #   permission to use the specified KMS key.
+    #   3.  Use the Amazon Resource Name (ARN) for the KMS key ID. For
+    #       example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
     #
+    #   4.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
+    #
+    #   If using a key located in a **different** Amazon Web Services
+    #   account than the current Amazon Web Services account, you can
+    #   specify your KMS key in one of two ways:
+    #
+    #   1.  Use the ARN for the KMS key ID. For example,
+    #       `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #
+    #   2.  Use the ARN for the KMS key alias. For example,
+    #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
+    #
+    #   If you do not specify an encryption key, your output is encrypted
+    #   with the default Amazon S3 key (SSE-S3).
     #
+    #   If you specify a KMS key to encrypt your output, you must also
+    #   specify an output location using the `OutputLocation` parameter.
     #
-    #   [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id-key-ARN
+    #   Note that the role making the request must have permission to use
+    #   the specified KMS key.
     #   @return [String]
     #
     # @!attribute [rw] kms_encryption_context

data/lib/aws-sdk-transcribeservice.rb

@@ -54,7 +54,7 @@ module Aws::TranscribeService
   autoload :EndpointProvider, 'aws-sdk-transcribeservice/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-transcribeservice/endpoints'
 
-  GEM_VERSION = '1.126.0'
+  GEM_VERSION = '1.127.0'
 
 end
 

data/sig/client.rbs

@@ -652,7 +652,12 @@ module Aws
                                           key: ::String,
                                           value: ::String
                                         },
-                                      ]
+                                      ],
+                                      ?medical_scribe_context: {
+                                        patient_context: {
+                                          pronouns: ("HE_HIM" | "SHE_HER" | "THEY_THEM")?
+                                        }?
+                                      }
                                     ) -> _StartMedicalScribeJobResponseSuccess
                                   | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _StartMedicalScribeJobResponseSuccess
 

data/sig/types.rbs

@@ -559,6 +559,11 @@ module Aws::TranscribeService
       SENSITIVE: []
     end
 
+    class MedicalScribeContext
+      attr_accessor patient_context: Types::MedicalScribePatientContext
+      SENSITIVE: []
+    end
+
     class MedicalScribeJob
       attr_accessor medical_scribe_job_name: ::String
       attr_accessor medical_scribe_job_status: ("QUEUED" | "IN_PROGRESS" | "FAILED" | "COMPLETED")
@@ -572,6 +577,7 @@ module Aws::TranscribeService
       attr_accessor settings: Types::MedicalScribeSettings
       attr_accessor data_access_role_arn: ::String
       attr_accessor channel_definitions: ::Array[Types::MedicalScribeChannelDefinition]
+      attr_accessor medical_scribe_context_provided: bool
       attr_accessor tags: ::Array[Types::Tag]
       SENSITIVE: []
     end
@@ -593,6 +599,11 @@ module Aws::TranscribeService
       SENSITIVE: []
     end
 
+    class MedicalScribePatientContext
+      attr_accessor pronouns: ("HE_HIM" | "SHE_HER" | "THEY_THEM")
+      SENSITIVE: [:pronouns]
+    end
+
     class MedicalScribeSettings
       attr_accessor show_speaker_labels: bool
       attr_accessor max_speaker_labels: ::Integer
@@ -748,6 +759,7 @@ module Aws::TranscribeService
       attr_accessor settings: Types::MedicalScribeSettings
       attr_accessor channel_definitions: ::Array[Types::MedicalScribeChannelDefinition]
       attr_accessor tags: ::Array[Types::Tag]
+      attr_accessor medical_scribe_context: Types::MedicalScribeContext
       SENSITIVE: []
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-transcribeservice
 version: !ruby/object:Gem::Version
-  version: 1.126.0
+  version: 1.127.0
 platform: ruby
 authors:
 - Amazon Web Services