aws-sdk-transcribeservice 1.92.0 → 1.93.0

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

@@ -1180,6 +1180,31 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
+    # Deletes a Medical Scribe job. To use this operation, specify the name
+    # of the job you want to delete using `MedicalScribeJobName`. Job names
+    # are case sensitive.
+    #
+    # @option params [required, String] :medical_scribe_job_name
+    #   The name of the Medical Scribe job you want to delete. Job names are
+    #   case sensitive.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_medical_scribe_job({
+    #     medical_scribe_job_name: "TranscriptionJobName", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/DeleteMedicalScribeJob AWS API Documentation
+    #
+    # @overload delete_medical_scribe_job(params = {})
+    # @param [Hash] params ({})
+    def delete_medical_scribe_job(params = {}, options = {})
+      req = build_request(:delete_medical_scribe_job, params)
+      req.send_request(options)
+    end
+
     # Deletes a medical transcription job. To use this operation, specify
     # the name of the job you want to delete using
     # `MedicalTranscriptionJobName`. Job names are case sensitive.
@@ -1512,6 +1537,66 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
+    # Provides information about the specified Medical Scribe job.
+    #
+    # To view the status of the specified medical transcription job, check
+    # the `MedicalScribeJobStatus` field. If the status is `COMPLETED`, the
+    # job is finished. You can find the results at the location specified in
+    # `MedicalScribeOutput`. If the status is `FAILED`, `FailureReason`
+    # provides details on why your Medical Scribe job failed.
+    #
+    # To get a list of your Medical Scribe jobs, use the operation.
+    #
+    # @option params [required, String] :medical_scribe_job_name
+    #   The name of the Medical Scribe job you want information about. Job
+    #   names are case sensitive.
+    #
+    # @return [Types::GetMedicalScribeJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetMedicalScribeJobResponse#medical_scribe_job #medical_scribe_job} => Types::MedicalScribeJob
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_medical_scribe_job({
+    #     medical_scribe_job_name: "TranscriptionJobName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.medical_scribe_job.medical_scribe_job_name #=> String
+    #   resp.medical_scribe_job.medical_scribe_job_status #=> String, one of "QUEUED", "IN_PROGRESS", "FAILED", "COMPLETED"
+    #   resp.medical_scribe_job.language_code #=> String, one of "en-US"
+    #   resp.medical_scribe_job.media.media_file_uri #=> String
+    #   resp.medical_scribe_job.media.redacted_media_file_uri #=> String
+    #   resp.medical_scribe_job.medical_scribe_output.transcript_file_uri #=> String
+    #   resp.medical_scribe_job.medical_scribe_output.clinical_document_uri #=> String
+    #   resp.medical_scribe_job.start_time #=> Time
+    #   resp.medical_scribe_job.creation_time #=> Time
+    #   resp.medical_scribe_job.completion_time #=> Time
+    #   resp.medical_scribe_job.failure_reason #=> String
+    #   resp.medical_scribe_job.settings.show_speaker_labels #=> Boolean
+    #   resp.medical_scribe_job.settings.max_speaker_labels #=> Integer
+    #   resp.medical_scribe_job.settings.channel_identification #=> Boolean
+    #   resp.medical_scribe_job.settings.vocabulary_name #=> String
+    #   resp.medical_scribe_job.settings.vocabulary_filter_name #=> String
+    #   resp.medical_scribe_job.settings.vocabulary_filter_method #=> String, one of "remove", "mask", "tag"
+    #   resp.medical_scribe_job.data_access_role_arn #=> String
+    #   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.tags #=> Array
+    #   resp.medical_scribe_job.tags[0].key #=> String
+    #   resp.medical_scribe_job.tags[0].value #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/GetMedicalScribeJob AWS API Documentation
+    #
+    # @overload get_medical_scribe_job(params = {})
+    # @param [Hash] params ({})
+    def get_medical_scribe_job(params = {}, options = {})
+      req = build_request(:get_medical_scribe_job, params)
+      req.send_request(options)
+    end
+
     # Provides information about the specified medical transcription job.
     #
     # To view the status of the specified medical transcription job, check
@@ -1807,7 +1892,7 @@ module Aws::TranscribeService
     # @option params [Integer] :max_results
     #   The maximum number of Call Analytics categories to return in each page
     #   of results. If there are fewer results than the value that you
-    #   specify, only the actual results are returned. If you don't specify a
+    #   specify, only the actual results are returned. If you do not specify a
     #   value, a default of 5 is used.
     #
     # @return [Types::ListCallAnalyticsCategoriesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1898,7 +1983,7 @@ module Aws::TranscribeService
     #
     # @option params [String] :status
     #   Returns only Call Analytics jobs with the specified status. Jobs are
-    #   ordered by creation date, with the newest job first. If you don't
+    #   ordered by creation date, with the newest job first. If you do not
     #   include `Status`, all Call Analytics jobs are returned.
     #
     # @option params [String] :job_name_contains
@@ -1915,7 +2000,7 @@ module Aws::TranscribeService
     # @option params [Integer] :max_results
     #   The maximum number of Call Analytics jobs to return in each page of
     #   results. If there are fewer results than the value that you specify,
-    #   only the actual results are returned. If you don't specify a value, a
+    #   only the actual results are returned. If you do not specify a value, a
     #   default of 5 is used.
     #
     # @return [Types::ListCallAnalyticsJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1967,7 +2052,7 @@ module Aws::TranscribeService
     # @option params [String] :status_equals
     #   Returns only custom language models with the specified status.
     #   Language models are ordered by creation date, with the newest model
-    #   first. If you don't include `StatusEquals`, all custom language
+    #   first. If you do not include `StatusEquals`, all custom language
     #   models are returned.
     #
     # @option params [String] :name_contains
@@ -1984,7 +2069,7 @@ module Aws::TranscribeService
     # @option params [Integer] :max_results
     #   The maximum number of custom language models to return in each page of
     #   results. If there are fewer results than the value that you specify,
-    #   only the actual results are returned. If you don't specify a value, a
+    #   only the actual results are returned. If you do not specify a value, a
     #   default of 5 is used.
     #
     # @return [Types::ListLanguageModelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2028,6 +2113,74 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
+    # Provides a list of Medical Scribe jobs that match the specified
+    # criteria. If no criteria are specified, all Medical Scribe jobs are
+    # returned.
+    #
+    # To get detailed information about a specific Medical Scribe job, use
+    # the operation.
+    #
+    # @option params [String] :status
+    #   Returns only Medical Scribe jobs with the specified status. Jobs are
+    #   ordered by creation date, with the newest job first. If you do not
+    #   include `Status`, all Medical Scribe jobs are returned.
+    #
+    # @option params [String] :job_name_contains
+    #   Returns only the Medical Scribe jobs that contain the specified
+    #   string. The search is not case sensitive.
+    #
+    # @option params [String] :next_token
+    #   If your `ListMedicalScribeJobs` request returns more results than can
+    #   be displayed, `NextToken` is displayed in the response with an
+    #   associated string. To get the next page of results, copy this string
+    #   and repeat your request, including `NextToken` with the value of the
+    #   copied string. Repeat as needed to view all your results.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of Medical Scribe jobs to return in each page of
+    #   results. If there are fewer results than the value that you specify,
+    #   only the actual results are returned. If you do not specify a value, a
+    #   default of 5 is used.
+    #
+    # @return [Types::ListMedicalScribeJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListMedicalScribeJobsResponse#status #status} => String
+    #   * {Types::ListMedicalScribeJobsResponse#next_token #next_token} => String
+    #   * {Types::ListMedicalScribeJobsResponse#medical_scribe_job_summaries #medical_scribe_job_summaries} => Array<Types::MedicalScribeJobSummary>
+    #
+    # 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.list_medical_scribe_jobs({
+    #     status: "QUEUED", # accepts QUEUED, IN_PROGRESS, FAILED, COMPLETED
+    #     job_name_contains: "TranscriptionJobName",
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.status #=> String, one of "QUEUED", "IN_PROGRESS", "FAILED", "COMPLETED"
+    #   resp.next_token #=> String
+    #   resp.medical_scribe_job_summaries #=> Array
+    #   resp.medical_scribe_job_summaries[0].medical_scribe_job_name #=> String
+    #   resp.medical_scribe_job_summaries[0].creation_time #=> Time
+    #   resp.medical_scribe_job_summaries[0].start_time #=> Time
+    #   resp.medical_scribe_job_summaries[0].completion_time #=> Time
+    #   resp.medical_scribe_job_summaries[0].language_code #=> String, one of "en-US"
+    #   resp.medical_scribe_job_summaries[0].medical_scribe_job_status #=> String, one of "QUEUED", "IN_PROGRESS", "FAILED", "COMPLETED"
+    #   resp.medical_scribe_job_summaries[0].failure_reason #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/ListMedicalScribeJobs AWS API Documentation
+    #
+    # @overload list_medical_scribe_jobs(params = {})
+    # @param [Hash] params ({})
+    def list_medical_scribe_jobs(params = {}, options = {})
+      req = build_request(:list_medical_scribe_jobs, params)
+      req.send_request(options)
+    end
+
     # Provides a list of medical transcription jobs that match the specified
     # criteria. If no criteria are specified, all medical transcription jobs
     # are returned.
@@ -2038,7 +2191,7 @@ module Aws::TranscribeService
     # @option params [String] :status
     #   Returns only medical transcription jobs with the specified status.
     #   Jobs are ordered by creation date, with the newest job first. If you
-    #   don't include `Status`, all medical transcription jobs are returned.
+    #   do not include `Status`, all medical transcription jobs are returned.
     #
     # @option params [String] :job_name_contains
     #   Returns only the medical transcription jobs that contain the specified
@@ -2054,7 +2207,7 @@ module Aws::TranscribeService
     # @option params [Integer] :max_results
     #   The maximum number of medical transcription jobs to return in each
     #   page of results. If there are fewer results than the value that you
-    #   specify, only the actual results are returned. If you don't specify a
+    #   specify, only the actual results are returned. If you do not specify a
     #   value, a default of 5 is used.
     #
     # @return [Types::ListMedicalTranscriptionJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2117,13 +2270,13 @@ module Aws::TranscribeService
     # @option params [Integer] :max_results
     #   The maximum number of custom medical vocabularies to return in each
     #   page of results. If there are fewer results than the value that you
-    #   specify, only the actual results are returned. If you don't specify a
+    #   specify, only the actual results are returned. If you do not specify a
     #   value, a default of 5 is used.
     #
     # @option params [String] :state_equals
     #   Returns only custom medical vocabularies with the specified state.
     #   Custom vocabularies are ordered by creation date, with the newest
-    #   vocabulary first. If you don't include `StateEquals`, all custom
+    #   vocabulary first. If you do not include `StateEquals`, all custom
     #   medical vocabularies are returned.
     #
     # @option params [String] :name_contains
@@ -2224,7 +2377,7 @@ module Aws::TranscribeService
     #
     # @option params [String] :status
     #   Returns only transcription jobs with the specified status. Jobs are
-    #   ordered by creation date, with the newest job first. If you don't
+    #   ordered by creation date, with the newest job first. If you do not
     #   include `Status`, all transcription jobs are returned.
     #
     # @option params [String] :job_name_contains
@@ -2241,7 +2394,7 @@ module Aws::TranscribeService
     # @option params [Integer] :max_results
     #   The maximum number of transcription jobs to return in each page of
     #   results. If there are fewer results than the value that you specify,
-    #   only the actual results are returned. If you don't specify a value, a
+    #   only the actual results are returned. If you do not specify a value, a
     #   default of 5 is used.
     #
     # @return [Types::ListTranscriptionJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2315,13 +2468,13 @@ module Aws::TranscribeService
     # @option params [Integer] :max_results
     #   The maximum number of custom vocabularies to return in each page of
     #   results. If there are fewer results than the value that you specify,
-    #   only the actual results are returned. If you don't specify a value, a
+    #   only the actual results are returned. If you do not specify a value, a
     #   default of 5 is used.
     #
     # @option params [String] :state_equals
     #   Returns only custom vocabularies with the specified state.
     #   Vocabularies are ordered by creation date, with the newest vocabulary
-    #   first. If you don't include `StateEquals`, all custom medical
+    #   first. If you do not include `StateEquals`, all custom medical
     #   vocabularies are returned.
     #
     # @option params [String] :name_contains
@@ -2381,7 +2534,7 @@ module Aws::TranscribeService
     # @option params [Integer] :max_results
     #   The maximum number of custom vocabulary filters to return in each page
     #   of results. If there are fewer results than the value that you
-    #   specify, only the actual results are returned. If you don't specify a
+    #   specify, only the actual results are returned. If you do not specify a
     #   value, a default of 5 is used.
     #
     # @option params [String] :name_contains
@@ -2505,11 +2658,11 @@ module Aws::TranscribeService
     #   transcription job using the `CallAnalyticsJobName` parameter.
     #
     #   You can specify a KMS key to encrypt your output using the
-    #   `OutputEncryptionKMSKeyId` parameter. If you don't specify a KMS key,
+    #   `OutputEncryptionKMSKeyId` parameter. If you do not specify a KMS key,
     #   Amazon Transcribe uses the default Amazon S3 key for server-side
     #   encryption.
     #
-    #   If you don't specify `OutputLocation`, your transcript is placed in a
+    #   If you do not specify `OutputLocation`, your transcript is placed in a
     #   service-managed Amazon S3 bucket and you are provided with a URI to
     #   access your transcript.
     #
@@ -2542,7 +2695,7 @@ module Aws::TranscribeService
     #   2.  Use the ARN for the KMS key alias. For example,
     #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
-    #   If you don't specify an encryption key, your output is encrypted with
+    #   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
@@ -2670,6 +2823,257 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
+    # Transcribes patient-clinician conversations and generates clinical
+    # notes.
+    #
+    # Amazon Web Services HealthScribe automatically provides rich
+    # conversation transcripts, identifies speaker roles, classifies
+    # dialogues, extracts medical terms, and generates preliminary clinical
+    # notes. To learn more about these features, refer to [Amazon Web
+    # Services HealthScribe][1].
+    #
+    # To make a `StartMedicalScribeJob` request, you must first upload your
+    # media file into an Amazon S3 bucket; you can then specify the Amazon
+    # S3 location of the file using the `Media` parameter.
+    #
+    # You must include the following parameters in your
+    # `StartMedicalTranscriptionJob` request:
+    #
+    # * `DataAccessRoleArn`: The ARN of an IAM role with the these minimum
+    #   permissions: read permission on input file Amazon S3 bucket
+    #   specified in `Media`, write permission on the Amazon S3 bucket
+    #   specified in `OutputBucketName`, and full permissions on the KMS key
+    #   specified in `OutputEncryptionKMSKeyId` (if set). The role should
+    #   also allow `transcribe.amazonaws.com` to assume it.
+    #
+    # * `Media` (`MediaFileUri`): The Amazon S3 location of your media file.
+    #
+    # * `MedicalScribeJobName`: A custom name you create for your
+    #   MedicalScribe job that is unique within your Amazon Web Services
+    #   account.
+    #
+    # * `OutputBucketName`: The Amazon S3 bucket where you want your output
+    #   files stored.
+    #
+    # * `Settings`: A `MedicalScribeSettings` obect that must set exactly
+    #   one of `ShowSpeakerLabels` or `ChannelIdentification` to true. If
+    #   `ShowSpeakerLabels` is true, `MaxSpeakerLabels` must also be set.
+    #
+    # * `ChannelDefinitions`: A `MedicalScribeChannelDefinitions` array
+    #   should be set if and only if the `ChannelIdentification` value of
+    #   `Settings` is set to true.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/transcribe/latest/dg/health-scribe.html
+    #
+    # @option params [required, String] :medical_scribe_job_name
+    #   A unique name, chosen by you, for your Medical Scribe job.
+    #
+    #   This name is case sensitive, cannot contain spaces, and must be unique
+    #   within an Amazon Web Services account. If you try to create a new job
+    #   with the same name as an existing job, you get a `ConflictException`
+    #   error.
+    #
+    # @option params [required, Types::Media] :media
+    #   Describes the Amazon S3 location of the media file you want to use in
+    #   your request.
+    #
+    #   For information on supported media formats, refer to the `MediaFormat`
+    #   parameter or the [Media formats][1] section in the Amazon S3 Developer
+    #   Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/transcribe/latest/dg/how-input.html#how-input-audio
+    #
+    # @option params [required, String] :output_bucket_name
+    #   The name of the Amazon S3 bucket where you want your Medical Scribe
+    #   output stored. Do not include the `S3://` prefix of the specified
+    #   bucket.
+    #
+    #   Note that the role specified in the `DataAccessRoleArn` request
+    #   parameter must have permission to use the specified location. You can
+    #   change Amazon S3 permissions using the [Amazon Web Services Management
+    #   Console][1]. See also [Permissions Required for IAM User Roles][2].
+    #
+    #
+    #
+    #   [1]: https://console.aws.amazon.com/s3
+    #   [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 KMS key you want to use to encrypt your Medical Scribe output.
+    #
+    #   If using a key located in the **current** Amazon Web Services account,
+    #   you can specify your KMS key in one of four ways:
+    #
+    #   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:
+    #
+    #   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.
+    #
+    # @option params [Hash<String,String>] :kms_encryption_context
+    #   A map of plain text, non-secret key:value pairs, known as encryption
+    #   context pairs, that provide an added layer of security for your data.
+    #   For more information, see [KMS encryption context][1] and [Asymmetric
+    #   keys in KMS][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/transcribe/latest/dg/key-management.html#kms-context
+    #   [2]: https://docs.aws.amazon.com/transcribe/latest/dg/symmetric-asymmetric.html
+    #
+    # @option params [required, String] :data_access_role_arn
+    #   The Amazon Resource Name (ARN) of an IAM role that has permissions to
+    #   access the Amazon S3 bucket that contains your input files, write to
+    #   the output bucket, and use your KMS key if supplied. If the role that
+    #   you specify doesn’t have the appropriate permissions your request
+    #   fails.
+    #
+    #   IAM role ARNs have the format
+    #   `arn:partition:iam::account:role/role-name-with-path`. For example:
+    #   `arn:aws:iam::111122223333:role/Admin`.
+    #
+    #   For more information, see [IAM ARNs][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns
+    #
+    # @option params [required, Types::MedicalScribeSettings] :settings
+    #   Makes it possible to control how your Medical Scribe job is processed
+    #   using a `MedicalScribeSettings` object. Specify
+    #   `ChannelIdentification` if `ChannelDefinitions` are set. Enabled
+    #   `ShowSpeakerLabels` if `ChannelIdentification` and
+    #   `ChannelDefinitions` are not set. One and only one of
+    #   `ChannelIdentification` and `ShowSpeakerLabels` must be set. If
+    #   `ShowSpeakerLabels` is set, `MaxSpeakerLabels` must also be set. Use
+    #   `Settings` to specify a vocabulary or vocabulary filter or both using
+    #   `VocabularyName`, `VocabularyFilterName`. `VocabularyFilterMethod`
+    #   must be specified if `VocabularyFilterName` is set.
+    #
+    # @option params [Array<Types::MedicalScribeChannelDefinition>] :channel_definitions
+    #   Makes it possible to specify which speaker is on which channel. For
+    #   example, if the clinician is the first participant to speak, you would
+    #   set `ChannelId` of the first `ChannelDefinition` in the list to `0`
+    #   (to indicate the first channel) and `ParticipantRole` to `CLINICIAN`
+    #   (to indicate that it's the clinician speaking). Then you would set
+    #   the `ChannelId` of the second `ChannelDefinition` in the list to `1`
+    #   (to indicate the second channel) and `ParticipantRole` to `PATIENT`
+    #   (to indicate that it's the patient speaking).
+    #
+    # @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.
+    #
+    #   To learn more about using tags with Amazon Transcribe, refer to
+    #   [Tagging resources][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html
+    #
+    # @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
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_medical_scribe_job({
+    #     medical_scribe_job_name: "TranscriptionJobName", # required
+    #     media: { # required
+    #       media_file_uri: "Uri",
+    #       redacted_media_file_uri: "Uri",
+    #     },
+    #     output_bucket_name: "OutputBucketName", # required
+    #     output_encryption_kms_key_id: "KMSKeyId",
+    #     kms_encryption_context: {
+    #       "NonEmptyString" => "NonEmptyString",
+    #     },
+    #     data_access_role_arn: "DataAccessRoleArn", # required
+    #     settings: { # required
+    #       show_speaker_labels: false,
+    #       max_speaker_labels: 1,
+    #       channel_identification: false,
+    #       vocabulary_name: "VocabularyName",
+    #       vocabulary_filter_name: "VocabularyFilterName",
+    #       vocabulary_filter_method: "remove", # accepts remove, mask, tag
+    #     },
+    #     channel_definitions: [
+    #       {
+    #         channel_id: 1, # required
+    #         participant_role: "PATIENT", # required, accepts PATIENT, CLINICIAN
+    #       },
+    #     ],
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue", # required
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.medical_scribe_job.medical_scribe_job_name #=> String
+    #   resp.medical_scribe_job.medical_scribe_job_status #=> String, one of "QUEUED", "IN_PROGRESS", "FAILED", "COMPLETED"
+    #   resp.medical_scribe_job.language_code #=> String, one of "en-US"
+    #   resp.medical_scribe_job.media.media_file_uri #=> String
+    #   resp.medical_scribe_job.media.redacted_media_file_uri #=> String
+    #   resp.medical_scribe_job.medical_scribe_output.transcript_file_uri #=> String
+    #   resp.medical_scribe_job.medical_scribe_output.clinical_document_uri #=> String
+    #   resp.medical_scribe_job.start_time #=> Time
+    #   resp.medical_scribe_job.creation_time #=> Time
+    #   resp.medical_scribe_job.completion_time #=> Time
+    #   resp.medical_scribe_job.failure_reason #=> String
+    #   resp.medical_scribe_job.settings.show_speaker_labels #=> Boolean
+    #   resp.medical_scribe_job.settings.max_speaker_labels #=> Integer
+    #   resp.medical_scribe_job.settings.channel_identification #=> Boolean
+    #   resp.medical_scribe_job.settings.vocabulary_name #=> String
+    #   resp.medical_scribe_job.settings.vocabulary_filter_name #=> String
+    #   resp.medical_scribe_job.settings.vocabulary_filter_method #=> String, one of "remove", "mask", "tag"
+    #   resp.medical_scribe_job.data_access_role_arn #=> String
+    #   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.tags #=> Array
+    #   resp.medical_scribe_job.tags[0].key #=> String
+    #   resp.medical_scribe_job.tags[0].value #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/StartMedicalScribeJob AWS API Documentation
+    #
+    # @overload start_medical_scribe_job(params = {})
+    # @param [Hash] params ({})
+    def start_medical_scribe_job(params = {}, options = {})
+      req = build_request(:start_medical_scribe_job, params)
+      req.send_request(options)
+    end
+
     # Transcribes the audio from a medical dictation or conversation and
     # applies any additional Request Parameters you choose to include in
     # your request.
@@ -2682,7 +3086,7 @@ module Aws::TranscribeService
     #
     # To make a `StartMedicalTranscriptionJob` request, you must first
     # upload your media file into an Amazon S3 bucket; you can then specify
-    # the S3 location of the file using the `Media` parameter.
+    # the Amazon S3 location of the file using the `Media` parameter.
     #
     # You must include the following parameters in your
     # `StartMedicalTranscriptionJob` request:
@@ -2734,7 +3138,7 @@ module Aws::TranscribeService
     #   The sample rate, in hertz, of the audio track in your input media
     #   file.
     #
-    #   If you don't specify the media sample rate, Amazon Transcribe Medical
+    #   If you do not specify the media sample rate, Amazon Transcribe Medical
     #   determines it for you. If you specify the sample rate, it must match
     #   the rate detected by Amazon Transcribe Medical; if there's a mismatch
     #   between the value that you specify and the value detected, your job
@@ -2749,14 +3153,13 @@ module Aws::TranscribeService
     #   Describes the Amazon S3 location of the media file you want to use in
     #   your request.
     #
-    #   For information on supported media formats, refer to the
-    #   [MediaFormat][1] parameter or the [Media formats][2] section in the
-    #   Amazon S3 Developer Guide.
+    #   For information on supported media formats, refer to the `MediaFormat`
+    #   parameter or the [Media formats][1] section in the Amazon S3 Developer
+    #   Guide.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/APIReference/API_StartTranscriptionJob.html#transcribe-StartTranscriptionJob-request-MediaFormat
-    #   [2]: https://docs.aws.amazon.com/transcribe/latest/dg/how-input.html#how-input-audio
+    #   [1]: https://docs.aws.amazon.com/transcribe/latest/dg/how-input.html#how-input-audio
     #
     # @option params [required, String] :output_bucket_name
     #   The name of the Amazon S3 bucket where you want your medical
@@ -2846,7 +3249,7 @@ module Aws::TranscribeService
     #   2.  Use the ARN for the KMS key alias. For example,
     #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
-    #   If you don't specify an encryption key, your output is encrypted with
+    #   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
@@ -3008,7 +3411,7 @@ module Aws::TranscribeService
     #   `IdentifyMultipleLanguages`: If you know the language of your media
     #   file, specify it using the `LanguageCode` parameter; you can find
     #   all valid language codes in the [Supported languages][2] table. If
-    #   you don't know the languages spoken in your media, use either
+    #   you do not know the languages spoken in your media, use either
     #   `IdentifyLanguage` or `IdentifyMultipleLanguages` and let Amazon
     #   Transcribe identify the languages for you.
     #
@@ -3056,7 +3459,7 @@ module Aws::TranscribeService
     #   The sample rate, in hertz, of the audio track in your input media
     #   file.
     #
-    #   If you don't specify the media sample rate, Amazon Transcribe
+    #   If you do not specify the media sample rate, Amazon Transcribe
     #   determines it for you. If you specify the sample rate, it must match
     #   the rate detected by Amazon Transcribe. If there's a mismatch between
     #   the value that you specify and the value detected, your job fails. In
@@ -3090,7 +3493,7 @@ module Aws::TranscribeService
     #   Services Management Console][1]. See also [Permissions Required for
     #   IAM User Roles][2].
     #
-    #   If you don't specify `OutputBucketName`, your transcript is placed in
+    #   If you do not specify `OutputBucketName`, your transcript is placed in
     #   a service-managed Amazon S3 bucket and you are provided with a URI to
     #   access your transcript.
     #
@@ -3161,7 +3564,7 @@ module Aws::TranscribeService
     #   2.  Use the ARN for the KMS key alias. For example,
     #       `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
     #
-    #   If you don't specify an encryption key, your output is encrypted with
+    #   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
@@ -3223,8 +3626,10 @@ module Aws::TranscribeService
     # @option params [Types::ContentRedaction] :content_redaction
     #   Makes it possible to redact or flag specified personally identifiable
     #   information (PII) in your transcript. If you use `ContentRedaction`,
-    #   you must also include the sub-parameters: `PiiEntityTypes`,
-    #   `RedactionOutput`, and `RedactionType`.
+    #   you must also include the sub-parameters: `RedactionOutput` and
+    #   `RedactionType`. You can optionally include `PiiEntityTypes` to choose
+    #   which types of PII you want to redact. If you do not include
+    #   `PiiEntityTypes` in your request, all PII is redacted.
     #
     # @option params [Boolean] :identify_language
     #   Enables automatic language identification in your transcription job
@@ -4003,7 +4408,7 @@ module Aws::TranscribeService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-transcribeservice'
-      context[:gem_version] = '1.92.0'
+      context[:gem_version] = '1.93.0'
       Seahorse::Client::Request.new(handlers, context)
     end