aws-sdk-transcribeservice 1.71.0 → 1.74.0

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

@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
@@ -75,6 +76,7 @@ module Aws::TranscribeService
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
@@ -359,22 +361,27 @@ module Aws::TranscribeService
 
     # @!group API Operations
 
-    # Creates an analytics category. Amazon Transcribe applies the
-    # conditions specified by your analytics categories to your call
-    # analytics jobs. For each analytics category, you specify one or more
-    # rules. For example, you can specify a rule that the customer sentiment
-    # was neutral or negative within that category. If you start a call
-    # analytics job, Amazon Transcribe applies the category to the analytics
-    # job that you've specified.
+    # Creates a call analytics category. Amazon Transcribe applies the
+    # conditions specified by your call analytics categories to your call
+    # analytics jobs. For each analytics category, you must create between 1
+    # and 20 rules. For example, you can create a 'greeting' category with
+    # a rule that flags calls in which your agent does not use a specified
+    # phrase (for example: "Please note this call may be recorded.") in
+    # the first 15 seconds of the call. When you start a call analytics job,
+    # Amazon Transcribe applies all your existing call analytics categories
+    # to that job.
     #
     # @option params [required, String] :category_name
-    #   The name that you choose for your category when you create it.
+    #   A unique name, chosen by you, for your call analytics category. For
+    #   example, `sentiment-positive-last30seconds`.
     #
     # @option params [required, Array<Types::Rule>] :rules
-    #   To create a category, you must specify between 1 and 20 rules. For
-    #   each rule, you specify a filter to be applied to the attributes of the
-    #   call. For example, you can specify a sentiment filter to detect if the
-    #   customer's sentiment was negative or neutral.
+    #   Rules make up a call analytics category. When creating a call
+    #   analytics category, you must create between 1 and 20 rules for your
+    #   category. For each rule, you specify a filter you want applied to the
+    #   attributes of a call. For example, you can choose a sentiment filter
+    #   that detects if a customer's sentiment was positive during the last
+    #   30 seconds of the call.
     #
     # @return [Types::CreateCallAnalyticsCategoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -520,34 +527,43 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Creates a new custom language model. Use Amazon S3 prefixes to provide
-    # the location of your input files. The time it takes to create your
-    # model depends on the size of your training data.
+    # Creates a new custom language model. When creating a new language
+    # model, you must specify if you want a Wideband (audio sample rates
+    # over 16,000 Hz) or Narrowband (audio sample rates under 16,000 Hz)
+    # base model. You then include the S3 URI location of your training and
+    # tuning files, the language for the model, a unique name, and any tags
+    # you want associated with your model.
     #
     # @option params [required, String] :language_code
-    #   The language of the input text you're using to train your custom
-    #   language model.
+    #   The language of your custom language model; note that the language
+    #   code you select must match the language of your training and tuning
+    #   data.
     #
     # @option params [required, String] :base_model_name
-    #   The Amazon Transcribe standard language model, or base model used to
-    #   create your custom language model.
+    #   The Amazon Transcribe standard language model, or base model, used to
+    #   create your custom language model. Amazon Transcribe offers two
+    #   options for base models: Wideband and Narrowband.
     #
-    #   If you want to use your custom language model to transcribe audio with
-    #   a sample rate of 16,000 Hz or greater, choose `Wideband`.
-    #
-    #   If you want to use your custom language model to transcribe audio with
-    #   a sample rate that is less than 16,000 Hz, choose `Narrowband`.
+    #   If the audio you want to transcribe has a sample rate of 16,000 Hz or
+    #   greater, choose `WideBand`. To transcribe audio with a sample rate
+    #   less than 16,000 Hz, choose `NarrowBand`.
     #
     # @option params [required, String] :model_name
-    #   The name you choose for your custom language model when you create it.
+    #   The name of your new custom language model.
+    #
+    #   This name is case sensitive, cannot contain spaces, and must be unique
+    #   within an Amazon Web Services account. If you try to create a language
+    #   model with the same name as a previous language model, you get a
+    #   `ConflictException` error.
     #
     # @option params [required, Types::InputDataConfig] :input_data_config
-    #   Contains the data access role and the Amazon S3 prefixes to read the
-    #   required input files to create a custom language model.
+    #   Contains your data access role ARN (Amazon Resource Name) and the
+    #   Amazon S3 locations of your training (`S3Uri`) and tuning
+    #   (`TuningDataS3Uri`) data.
     #
     # @option params [Array<Types::Tag>] :tags
-    #   Adds one or more tags, each in the form of a key:value pair, to a new
-    #   language model at the time you create this new model.
+    #   Optionally add tags, each in the form of a key:value pair, to your new
+    #   language model. See also: .
     #
     # @return [Types::CreateLanguageModelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -595,48 +611,53 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Creates a new custom vocabulary that you can use to modify how Amazon
-    # Transcribe Medical transcribes your audio file.
+    # Creates a new custom medical vocabulary.
+    #
+    # When creating a new medical vocabulary, you must upload a text file
+    # that contains your new entries, phrases, and terms into an S3 bucket.
+    # Note that this differs from , where you can include a list of terms
+    # within your request using the `Phrases` flag, as
+    # `CreateMedicalVocabulary` does not support the `Phrases` flag.
+    #
+    # For more information on creating a custom vocabulary text file, see
+    # [Creating a custom vocabulary][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/transcribe/latest/dg/custom-vocabulary-create.html
     #
     # @option params [required, String] :vocabulary_name
-    #   The name of the custom vocabulary. This case-sensitive name must be
-    #   unique within an Amazon Web Services account. If you try to create a
+    #   The name of your new vocabulary.
+    #
+    #   This name is case sensitive, cannot contain spaces, and must be unique
+    #   within an Amazon Web Services account. If you try to create a
     #   vocabulary with the same name as a previous vocabulary, you get a
     #   `ConflictException` error.
     #
     # @option params [required, String] :language_code
-    #   The language code for the language used for the entries in your custom
-    #   vocabulary. The language code of your custom vocabulary must match the
-    #   language code of your transcription job. US English (en-US) is the
-    #   only language code available for Amazon Transcribe Medical.
+    #   The language code that represents the language of the entries in your
+    #   custom vocabulary. Note that U.S. English (`en-US`) is the only
+    #   language supported with Amazon Transcribe Medical.
     #
     # @option params [required, String] :vocabulary_file_uri
-    #   The location in Amazon S3 of the text file you use to define your
+    #   The Amazon S3 location (URI) of the text file that contains your
     #   custom vocabulary. The URI must be in the same Amazon Web Services
-    #   Region as the resource that you're calling. Enter information about
-    #   your `VocabularyFileUri` in the following format:
-    #
-    #   `https://s3.<aws-region>.amazonaws.com/<bucket-name>/<keyprefix>/<objectkey>`
-    #
-    #   The following is an example URI for a vocabulary file that is stored
-    #   in Amazon S3:
+    #   Region as the resource that you're calling.
     #
-    #   `https://s3.us-east-1.amazonaws.com/AWSDOC-EXAMPLE-BUCKET/vocab.txt`
+    #   Here's an example URI path:
     #
-    #   For more information about Amazon S3 object names, see [Object
-    #   Keys][1] in the *Amazon S3 Developer Guide*.
+    #   `https://s3.us-east-1.amazonaws.com/my-s3-bucket/my-vocab-file.txt`
     #
-    #   For more information about custom vocabularies, see [Medical Custom
-    #   Vocabularies][2].
+    # @option params [Array<Types::Tag>] :tags
+    #   Adds one or more tags, each in the form of a key:value pair, to a new
+    #   medical vocabulary at the time you create the new vocabulary.
     #
+    #   To learn more about using tags with Amazon Transcribe, refer to
+    #   [Tagging resources][1].
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#object-keys
-    #   [2]: https://docs.aws.amazon.com/transcribe/latest/dg/vocabulary-med.html
     #
-    # @option params [Array<Types::Tag>] :tags
-    #   Adds one or more tags, each in the form of a key:value pair, to a new
-    #   medical vocabulary at the time you create this new vocabulary.
+    #   [1]: https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html
     #
     # @return [Types::CreateMedicalVocabularyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -677,50 +698,59 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Creates a new custom vocabulary that you can use to change the way
-    # Amazon Transcribe handles transcription of an audio file.
+    # Creates a new custom vocabulary.
+    #
+    # When creating a new medical vocabulary, you can either upload a text
+    # file that contains your new entries, phrases, and terms into an S3
+    # bucket or include a list of terms directly in your request using the
+    # `Phrases` flag.
+    #
+    # For more information on creating a custom vocabulary, see [Creating a
+    # custom vocabulary][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/transcribe/latest/dg/custom-vocabulary-create.html
     #
     # @option params [required, String] :vocabulary_name
-    #   The name of the vocabulary. The name must be unique within an Amazon
-    #   Web Services account. The name is case sensitive. If you try to create
-    #   a vocabulary with the same name as a previous vocabulary you will
-    #   receive a `ConflictException` error.
+    #   The name of your new vocabulary.
     #
-    # @option params [required, String] :language_code
-    #   The language code of the vocabulary entries. For a list of languages
-    #   and their corresponding language codes, see table-language-matrix.
+    #   This name is case sensitive, cannot contain spaces, and must be unique
+    #   within an Amazon Web Services account. If you try to create a
+    #   vocabulary with the same name as a previous vocabulary, you get a
+    #   `ConflictException` error.
     #
-    # @option params [Array<String>] :phrases
-    #   An array of strings that contains the vocabulary entries.
+    # @option params [required, String] :language_code
+    #   The language code that represents the language of the entries in your
+    #   custom vocabulary. Each vocabulary must contain terms in only one
+    #   language. For a list of languages and their corresponding language
+    #   codes, see [Supported languages][1].
     #
-    # @option params [String] :vocabulary_file_uri
-    #   The S3 location of the text file that contains the definition of the
-    #   custom vocabulary. The URI must be in the same region as the API
-    #   endpoint that you are calling. The general form is:
     #
-    #   `https://s3.<Amazon Web
-    #   Services-region>.amazonaws.com/<AWSDOC-EXAMPLE-BUCKET>/<keyprefix>/<objectkey>
-    #   `
     #
-    #   For example:
+    #   [1]: https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html
     #
-    #   `https://s3.us-east-1.amazonaws.com/AWSDOC-EXAMPLE-BUCKET/vocab.txt`
+    # @option params [Array<String>] :phrases
+    #   Use this flag to include a list of terms within your request.
     #
-    #   For more information about S3 object names, see [Object Keys][1] in
-    #   the *Amazon S3 Developer Guide*.
+    #   Note that if you include `Phrases` in your request, you cannot use
+    #   `VocabularyFileUri`; you must choose one or the other.
     #
-    #   For more information about custom vocabularies, see [Custom
-    #   vocabularies][2].
+    # @option params [String] :vocabulary_file_uri
+    #   The S3 location of the text file that contains your custom vocabulary.
+    #   The URI must be located in the same region as the API endpoint you're
+    #   calling.
     #
+    #   Here's an example URI path:
     #
+    #   `https://s3.us-east-1.amazonaws.com/my-s3-bucket/my-vocab-file.txt`
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#object-keys
-    #   [2]: https://docs.aws.amazon.com/transcribe/latest/dg/custom-vocabulary.html
+    #   Note that if you include `VocabularyFileUri` in your request, you
+    #   cannot use the `Phrases` flag; you must choose one or the other.
     #
     # @option params [Array<Types::Tag>] :tags
     #   Adds one or more tags, each in the form of a key:value pair, to a new
-    #   Amazon Transcribe vocabulary at the time you create this new
-    #   vocabulary.
+    #   custom vocabulary at the time you create this new vocabulary.
     #
     # @return [Types::CreateVocabularyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -762,14 +792,17 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Creates a new vocabulary filter that you can use to filter words, such
-    # as profane words, from the output of a transcription job.
+    # Creates a new vocabulary filter that you can use to filter words from
+    # your transcription output. For example, you can use this operation to
+    # remove profanity from your transcript.
     #
     # @option params [required, String] :vocabulary_filter_name
-    #   The vocabulary filter name. The name must be unique within the account
-    #   that contains it. If you try to create a vocabulary filter with the
-    #   same name as another vocabulary filter, you get a `ConflictException`
-    #   error.
+    #   The name of your new vocabulary filter.
+    #
+    #   This name is case sensitive, cannot contain spaces, and must be unique
+    #   within an Amazon Web Services account. If you try to create a
+    #   vocabulary filter with the same name as a previous vocabulary filter,
+    #   you get a `ConflictException` error.
     #
     # @option params [required, String] :language_code
     #   The language code of the words in the vocabulary filter. All words in
@@ -777,12 +810,12 @@ module Aws::TranscribeService
     #   only be used with transcription jobs in the specified language.
     #
     # @option params [Array<String>] :words
-    #   The words to use in the vocabulary filter. Only use characters from
-    #   the character set defined for custom vocabularies. For a list of
-    #   character sets, see [Character Sets for Custom Vocabularies][1].
+    #   The words you want in your vocabulary filter. Only use characters
+    #   specified in the [Character sets][1] for the language you're
+    #   transcribing.
     #
-    #   If you provide a list of words in the `Words` parameter, you can't
-    #   use the `VocabularyFilterFileUri` parameter.
+    #   Note that if you include `Words` in your request, you cannot use
+    #   `VocabularyFilterFileUri`; you must choose one or the other.
     #
     #
     #
@@ -794,11 +827,10 @@ module Aws::TranscribeService
     #   for custom vocabularies. For a list of character sets, see [Character
     #   Sets for Custom Vocabularies][1].
     #
-    #   The specified file must be less than 50 KB of UTF-8 characters.
+    #   Your vocabulary filter file must be less than 50 KB in size.
     #
-    #   If you provide the location of a list of words in the
-    #   `VocabularyFilterFileUri` parameter, you can't use the `Words`
-    #   parameter.
+    #   Note that if you include `VocabularyFilterFileUri` in your request,
+    #   you cannot use `Words`; you must choose one or the other.
     #
     #
     #
@@ -806,8 +838,7 @@ module Aws::TranscribeService
     #
     # @option params [Array<Types::Tag>] :tags
     #   Adds one or more tags, each in the form of a key:value pair, to a new
-    #   Amazon Transcribe vocabulary filter at the time you create this new
-    #   vocabulary filter.
+    #   vocabulary filter at the time you create this new vocabulary filter.
     #
     # @return [Types::CreateVocabularyFilterResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -845,11 +876,12 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Deletes a call analytics category using its name.
+    # Deletes a call analytics category. To use this operation, specify the
+    # name of the category you want to delete using `CategoryName`.
     #
     # @option params [required, String] :category_name
-    #   The name of the call analytics category that you're choosing to
-    #   delete. The value is case sensitive.
+    #   The name of the call analytics category you want to delete. Category
+    #   names are case-sensitive.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -868,10 +900,12 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Deletes a call analytics job using its name.
+    # Deletes a call analytics job. To use this operation, specify the name
+    # of the job you want to delete using `CallAnalyticsJobName`.
     #
     # @option params [required, String] :call_analytics_job_name
-    #   The name of the call analytics job you want to delete.
+    #   The name of the call analytics job you want to delete. Job names are
+    #   case-sensitive.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -890,10 +924,12 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Deletes a custom language model using its name.
+    # Deletes a custom language model. To use this operation, specify the
+    # name of the language model you want to delete using `ModelName`.
     #
     # @option params [required, String] :model_name
-    #   The name of the model you're choosing to delete.
+    #   The name of the model you want to delete. Model names are
+    #   case-sensitive.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -912,12 +948,13 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Deletes a transcription job generated by Amazon Transcribe Medical and
-    # any related information.
+    # Deletes a medical transcription job, along with any related
+    # information. To use this operation, specify the name of the job you
+    # want to delete using `MedicalTranscriptionJobName`.
     #
     # @option params [required, String] :medical_transcription_job_name
-    #   The name you provide to the `DeleteMedicalTranscriptionJob` object to
-    #   delete a transcription job.
+    #   The name of the medical transcription job you want to delete. Job
+    #   names are case-sensitive.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -936,10 +973,12 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Deletes a vocabulary from Amazon Transcribe Medical.
+    # Deletes a custom medical vocabulary. To use this operation, specify
+    # the name of the vocabulary you want to delete using `VocabularyName`.
     #
     # @option params [required, String] :vocabulary_name
-    #   The name of the vocabulary that you want to delete.
+    #   The name of the vocabulary that you want to delete. Vocabulary names
+    #   are case-sensitive.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -958,11 +997,13 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Deletes a previously submitted transcription job along with any other
-    # generated results such as the transcription, models, and so on.
+    # Deletes a transcription job, along with any related information. To
+    # use this operation, specify the name of the job you want to delete
+    # using `TranscriptionJobName`.
     #
     # @option params [required, String] :transcription_job_name
-    #   The name of the transcription job to be deleted.
+    #   The name of the transcription job you want to delete. Job names are
+    #   case-sensitive.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -981,10 +1022,12 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Deletes a vocabulary from Amazon Transcribe.
+    # Deletes a custom vocabulary. To use this operation, specify the name
+    # of the vocabulary you want to delete using `VocabularyName`.
     #
     # @option params [required, String] :vocabulary_name
-    #   The name of the vocabulary to delete.
+    #   The name of the vocabulary you want to delete. Vocabulary names are
+    #   case-sensitive.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1003,10 +1046,13 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Removes a vocabulary filter.
+    # Deletes a vocabulary filter. To use this operation, specify the name
+    # of the vocabulary filter you want to delete using
+    # `VocabularyFilterName`.
     #
     # @option params [required, String] :vocabulary_filter_name
-    #   The name of the vocabulary filter to remove.
+    #   The name of the vocabulary filter you want to delete. Vocabulary
+    #   filter names are case-sensitive.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1025,18 +1071,21 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Gets information about a single custom language model. Use this
-    # information to see details about the language model in your Amazon Web
-    # Services account. You can also see whether the base language model
-    # used to create your custom language model has been updated. If Amazon
+    # Provides information about a specific custom language model in your
+    # Amazon Web Services account.
+    #
+    # This operation also shows if the base language model you used to
+    # create your custom language model has been updated. If Amazon
     # Transcribe has updated the base model, you can create a new custom
-    # language model using the updated base model. If the language model
-    # wasn't created, you can use this operation to understand why Amazon
-    # Transcribe couldn't create it.
+    # language model using the updated base model.
+    #
+    # If you tried to create a new custom language model and the request
+    # wasn't successful, you can use this operation to help identify the
+    # reason.
     #
     # @option params [required, String] :model_name
-    #   The name of the custom language model you submit to get more
-    #   information.
+    #   The name of the custom language model you want described. Model names
+    #   are case-sensitive.
     #
     # @return [Types::DescribeLanguageModelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1074,8 +1123,8 @@ module Aws::TranscribeService
     # Retrieves information about a call analytics category.
     #
     # @option params [required, String] :category_name
-    #   The name of the category you want information about. This value is
-    #   case sensitive.
+    #   The name of the category you want information about. Category names
+    #   are case sensitive.
     #
     # @return [Types::GetCallAnalyticsCategoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1149,12 +1198,14 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Returns information about a call analytics job. To see the status of
-    # the job, check the `CallAnalyticsJobStatus` field. If the status is
-    # `COMPLETED`, the job is finished and you can find the results at the
-    # location specified in the `TranscriptFileUri` field. If you enable
-    # personally identifiable information (PII) redaction, the redacted
-    # transcript appears in the `RedactedTranscriptFileUri` field.
+    # Retrieves information about a call analytics job.
+    #
+    # To view the job's status, refer to the `CallAnalyticsJobStatus`
+    # field. If the status is `COMPLETED`, the job is finished. You can then
+    # find your transcript at the URI specified in the `TranscriptFileUri`
+    # field. If you enabled personally identifiable information (PII)
+    # redaction, the redacted transcript appears in the
+    # `RedactedTranscriptFileUri` field.
     #
     # @option params [required, String] :call_analytics_job_name
     #   The name of the analytics job you want information about. This value
@@ -1214,14 +1265,16 @@ module Aws::TranscribeService
       req.send_request(options)
     end
 
-    # Returns information about a transcription job from Amazon Transcribe
-    # Medical. To see the status of the job, check the
-    # `TranscriptionJobStatus` field. If the status is `COMPLETED`, the job
-    # is finished. You find the results of the completed job in the
-    # `TranscriptFileUri` field.
+    # Retrieves information about a medical transcription job.
+    #
+    # To view the job's status, refer to the `TranscriptionJobStatus`
+    # field. If the status is `COMPLETED`, the job is finished. You can then
+    # find your transcript at the URI specified in the `TranscriptFileUri`
+    # field.
     #
     # @option params [required, String] :medical_transcription_job_name
-    #   The name of the medical transcription job.
+    #   The name of the medical transcription job you want information about.
+    #   This value is case sensitive.
     #
     # @return [Types::GetMedicalTranscriptionJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1272,8 +1325,8 @@ module Aws::TranscribeService
     # Retrieves information about a medical vocabulary.
     #
     # @option params [required, String] :vocabulary_name
-    #   The name of the vocabulary that you want information about. The value
-    #   is case sensitive.
+    #   The name of the medical vocabulary you want information about. This
+    #   value is case sensitive.
     #
     # @return [Types::GetMedicalVocabularyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1369,6 +1422,7 @@ module Aws::TranscribeService
     #   resp.transcription_job.subtitles.formats[0] #=> String, one of "vtt", "srt"
     #   resp.transcription_job.subtitles.subtitle_file_uris #=> Array
     #   resp.transcription_job.subtitles.subtitle_file_uris[0] #=> String
+    #   resp.transcription_job.subtitles.output_start_index #=> Integer
     #   resp.transcription_job.language_id_settings #=> Hash
     #   resp.transcription_job.language_id_settings["LanguageCode"].vocabulary_name #=> String
     #   resp.transcription_job.language_id_settings["LanguageCode"].vocabulary_filter_name #=> String
@@ -2331,7 +2385,7 @@ module Aws::TranscribeService
     #   dictated speech, such as clinical notes.
     #
     # @option params [Array<Types::Tag>] :tags
-    #   Add tags to an Amazon Transcribe medical transcription job.
+    #   Add tags to an Amazon Transcribe Medical transcription job.
     #
     # @return [Types::StartMedicalTranscriptionJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2419,7 +2473,9 @@ module Aws::TranscribeService
     #   `ConflictException` error.
     #
     # @option params [String] :language_code
-    #   The language code for the language used in the input media file.
+    #   The language code for the language used in the input media file. You
+    #   must include either `LanguageCode` or `IdentifyLanguage` in your
+    #   request.
     #
     #   To transcribe speech in Modern Standard Arabic (ar-SA), your audio or
     #   video file must be encoded at a sample rate of 16,000 Hz or higher.
@@ -2547,6 +2603,9 @@ module Aws::TranscribeService
     #   a `BadRequestException` error if you enter a value for a
     #   `LanguageCode`.
     #
+    #   You must include either `LanguageCode` or `IdentifyLanguage` in your
+    #   request.
+    #
     # @option params [Array<String>] :language_options
     #   An object containing a list of languages that might be present in your
     #   collection of audio files. Automatic language identification chooses a
@@ -2613,6 +2672,7 @@ module Aws::TranscribeService
     #     language_options: ["af-ZA"], # accepts af-ZA, ar-AE, ar-SA, cy-GB, da-DK, de-CH, de-DE, en-AB, en-AU, en-GB, en-IE, en-IN, en-US, en-WL, es-ES, es-US, fa-IR, fr-CA, fr-FR, ga-IE, gd-GB, he-IL, hi-IN, id-ID, it-IT, ja-JP, ko-KR, ms-MY, nl-NL, pt-BR, pt-PT, ru-RU, ta-IN, te-IN, tr-TR, zh-CN, zh-TW, th-TH, en-ZA, en-NZ
     #     subtitles: {
     #       formats: ["vtt"], # accepts vtt, srt
+    #       output_start_index: 1,
     #     },
     #     tags: [
     #       {
@@ -2670,6 +2730,7 @@ module Aws::TranscribeService
     #   resp.transcription_job.subtitles.formats[0] #=> String, one of "vtt", "srt"
     #   resp.transcription_job.subtitles.subtitle_file_uris #=> Array
     #   resp.transcription_job.subtitles.subtitle_file_uris[0] #=> String
+    #   resp.transcription_job.subtitles.output_start_index #=> Integer
     #   resp.transcription_job.language_id_settings #=> Hash
     #   resp.transcription_job.language_id_settings["LanguageCode"].vocabulary_name #=> String
     #   resp.transcription_job.language_id_settings["LanguageCode"].vocabulary_filter_name #=> String
@@ -2935,13 +2996,11 @@ module Aws::TranscribeService
     #   the resource that you are calling. The following is the format for a
     #   URI:
     #
-    #   `
-    #   https://s3.<aws-region>.amazonaws.com/<bucket-name>/<keyprefix>/<objectkey>
-    #   `
+    #   `https://s3.aws-region.amazonaws.com/bucket-name/keyprefix/objectkey`
     #
     #   For example:
     #
-    #   `https://s3.us-east-1.amazonaws.com/AWSDOC-EXAMPLE-BUCKET/vocab.txt`
+    #   `https://s3.us-east-1.amazonaws.com/DOC-EXAMPLE-BUCKET/vocab.txt`
     #
     #   For more information about Amazon S3 object names, see [Object
     #   Keys][1] in the *Amazon S3 Developer Guide*.
@@ -3010,11 +3069,11 @@ module Aws::TranscribeService
     #   custom vocabulary. The URI must be in the same region as the API
     #   endpoint that you are calling. The general form is:
     #
-    #   `https://s3.<aws-region>.amazonaws.com/<AWSDOC-EXAMPLE-BUCKET>/<keyprefix>/<objectkey>`
+    #   `https://s3.aws-region.amazonaws.com/bucket-name/keyprefix/objectkey`
     #
     #   For example:
     #
-    #   `https://s3.us-east-1.amazonaws.com/AWSDOC-EXAMPLE-BUCKET/vocab.txt`
+    #   `https://s3.us-east-1.amazonaws.com/DOC-EXAMPLE-BUCKET/vocab.txt`
     #
     #   For more information about S3 object names, see [Object Keys][1] in
     #   the *Amazon S3 Developer Guide*.
@@ -3136,7 +3195,7 @@ module Aws::TranscribeService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-transcribeservice'
-      context[:gem_version] = '1.71.0'
+      context[:gem_version] = '1.74.0'
       Seahorse::Client::Request.new(handlers, context)
     end