aws-sdk-translate 1.42.0 → 1.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dbccaa5325a7a60643eccd5b4eabf0891c06df99218dcc7191e3fbe97187d676
-  data.tar.gz: 6dc19563254ffc0d8a21aa57b7e60cd8281e94b8e017c7f6a17eabd8f73c3dfc
+  metadata.gz: abd066b6c5b9dac4d629ffbbc189078b1ad429a8feca5970634bfa4df1aea81e
+  data.tar.gz: 0dc26a80eb1dd895d3bf5c4e1720818cf1b7cf0849527f5d41ac0572c16ff23a
 SHA512:
-  metadata.gz: b88054715b10c07e9cc7fa8f4eecc056ca64310b8eee914f00c8b135f2a2f5fe97742cf18466ff09da7bd5e87d9213a420e202f4a89c845b60ff4233ed0fbf60
-  data.tar.gz: a8ac4364655e9945b2a62484442050959fd6728dc2766ecb3f6da751573b9e00d0122c274fc79de1985a68557df96271b37725f2cf33f22cd7c84435d18804dd
+  metadata.gz: 84d26f6c04e0c0193f23517a6bd6161ab896df0f9a150ed7b27157f5d2184deee3df26c9a4274a4fecfb355ee38fffbe6f9c8188ec21548baf2206e7b03bef1c
+  data.tar.gz: a5c833133ca4feb63679f1ee0edf21aba3967daf1af88e421ec75157190e6092c530dc5666f1e53ac2ab27e783da1b99a2f986bc37a46a74d1c763a11ab348b8

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.45.0 (2022-06-29)
+------------------
+
+* Feature - Added ListLanguages API which can be used to list the languages supported by Translate.
+
+1.44.0 (2022-02-24)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.43.0 (2022-02-22)
+------------------
+
+* Feature - This release enables customers to use translation settings for formality customization in their synchronous translation output.
+
 1.42.0 (2022-02-03)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.42.0
+1.45.0

data/lib/aws-sdk-translate/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::Translate
     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)
@@ -516,6 +518,7 @@ module Aws::Translate
     #   resp.text_translation_job_properties.output_data_config.encryption_key.type #=> String, one of "KMS"
     #   resp.text_translation_job_properties.output_data_config.encryption_key.id #=> String
     #   resp.text_translation_job_properties.data_access_role_arn #=> String
+    #   resp.text_translation_job_properties.settings.formality #=> String, one of "FORMAL", "INFORMAL"
     #   resp.text_translation_job_properties.settings.profanity #=> String, one of "MASK"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/DescribeTextTranslationJob AWS API Documentation
@@ -592,12 +595,12 @@ module Aws::Translate
     #   The data format of the custom terminology being retrieved.
     #
     #   If you don't specify this parameter, Amazon Translate returns a file
-    #   that has the same format as the file that was imported to create the
+    #   with the same format as the file that was imported to create the
     #   terminology.
     #
     #   If you specify this parameter when you retrieve a multi-directional
-    #   terminology resource, you must specify the same format as that of the
-    #   input file that was imported to create it. Otherwise, Amazon Translate
+    #   terminology resource, you must specify the same format as the input
+    #   file that was imported to create it. Otherwise, Amazon Translate
     #   throws an error.
     #
     # @return [Types::GetTerminologyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -645,17 +648,16 @@ module Aws::Translate
       req.send_request(options)
     end
 
-    # Creates or updates a custom terminology, depending on whether or not
-    # one already exists for the given terminology name. Importing a
-    # terminology with the same name as an existing one will merge the
-    # terminologies based on the chosen merge strategy. Currently, the only
-    # supported merge strategy is OVERWRITE, and so the imported terminology
-    # will overwrite an existing terminology of the same name.
+    # Creates or updates a custom terminology, depending on whether one
+    # already exists for the given terminology name. Importing a terminology
+    # with the same name as an existing one will merge the terminologies
+    # based on the chosen merge strategy. The only supported merge strategy
+    # is OVERWRITE, where the imported terminology overwrites the existing
+    # terminology of the same name.
     #
     # If you import a terminology that overwrites an existing one, the new
-    # terminology take up to 10 minutes to fully propagate and be available
-    # for use in a translation due to cache policies with the DataPlane
-    # service that performs the translations.
+    # terminology takes up to 10 minutes to fully propagate. After that,
+    # translations have access to the new terminology.
     #
     # @option params [required, String] :name
     #   The name of the custom terminology being imported.
@@ -727,6 +729,53 @@ module Aws::Translate
       req.send_request(options)
     end
 
+    # Provides a list of languages (RFC-5646 codes and names) that Amazon
+    # Translate supports.
+    #
+    # @option params [String] :display_language_code
+    #   The language code for the language to use to display the language
+    #   names in the response. The language code is `en` by default.
+    #
+    # @option params [String] :next_token
+    #   Include the NextToken value to fetch the next group of supported
+    #   languages.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return in each response.
+    #
+    # @return [Types::ListLanguagesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListLanguagesResponse#languages #languages} => Array<Types::Language>
+    #   * {Types::ListLanguagesResponse#display_language_code #display_language_code} => String
+    #   * {Types::ListLanguagesResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_languages({
+    #     display_language_code: "de", # accepts de, en, es, fr, it, ja, ko, pt, zh, zh-TW
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.languages #=> Array
+    #   resp.languages[0].language_name #=> String
+    #   resp.languages[0].language_code #=> String
+    #   resp.display_language_code #=> String, one of "de", "en", "es", "fr", "it", "ja", "ko", "pt", "zh", "zh-TW"
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/ListLanguages AWS API Documentation
+    #
+    # @overload list_languages(params = {})
+    # @param [Hash] params ({})
+    def list_languages(params = {}, options = {})
+      req = build_request(:list_languages, params)
+      req.send_request(options)
+    end
+
     # Provides a list of your parallel data resources in Amazon Translate.
     #
     # @option params [String] :next_token
@@ -897,6 +946,7 @@ module Aws::Translate
     #   resp.text_translation_job_properties_list[0].output_data_config.encryption_key.type #=> String, one of "KMS"
     #   resp.text_translation_job_properties_list[0].output_data_config.encryption_key.id #=> String
     #   resp.text_translation_job_properties_list[0].data_access_role_arn #=> String
+    #   resp.text_translation_job_properties_list[0].settings.formality #=> String, one of "FORMAL", "INFORMAL"
     #   resp.text_translation_job_properties_list[0].settings.profanity #=> String, one of "MASK"
     #   resp.next_token #=> String
     #
@@ -927,7 +977,7 @@ module Aws::Translate
     #   The name of the batch translation job to be performed.
     #
     # @option params [required, Types::InputDataConfig] :input_data_config
-    #   Specifies the format and S3 location of the input documents for the
+    #   Specifies the format and location of the input documents for the
     #   translation job.
     #
     # @option params [required, Types::OutputDataConfig] :output_data_config
@@ -984,15 +1034,16 @@ module Aws::Translate
     #   [1]: http://aws.amazon.com/translate/pricing/
     #
     # @option params [required, String] :client_token
-    #   A unique identifier for the request. This token is auto-generated when
-    #   using the Amazon Translate SDK.
+    #   A unique identifier for the request. This token is generated for you
+    #   when using the Amazon Translate SDK.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
     # @option params [Types::TranslationSettings] :settings
     #   Settings to configure your translation output, including the option to
-    #   mask profane words and phrases.
+    #   mask profane words and phrases. `StartTextTranslationJob` does not
+    #   support the formality setting.
     #
     # @return [Types::StartTextTranslationJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1021,6 +1072,7 @@ module Aws::Translate
     #     parallel_data_names: ["ResourceName"],
     #     client_token: "ClientTokenString", # required
     #     settings: {
+    #       formality: "FORMAL", # accepts FORMAL, INFORMAL
     #       profanity: "MASK", # accepts MASK
     #     },
     #   })
@@ -1103,6 +1155,12 @@ module Aws::Translate
     #   specify `auto`, Amazon Translate will call [Amazon Comprehend][1] to
     #   determine the source language.
     #
+    #   <note markdown="1"> If you specify `auto`, you must send the `TranslateText` request in a
+    #   region that supports Amazon Comprehend. Otherwise, the request returns
+    #   an error indicating that autodetect is not supported.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/comprehend/latest/dg/comprehend-general.html
@@ -1113,7 +1171,8 @@ module Aws::Translate
     #
     # @option params [Types::TranslationSettings] :settings
     #   Settings to configure your translation output, including the option to
-    #   mask profane words and phrases.
+    #   set the formality level of the output text and the option to mask
+    #   profane words and phrases.
     #
     # @return [Types::TranslateTextResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1131,6 +1190,7 @@ module Aws::Translate
     #     source_language_code: "LanguageCodeString", # required
     #     target_language_code: "LanguageCodeString", # required
     #     settings: {
+    #       formality: "FORMAL", # accepts FORMAL, INFORMAL
     #       profanity: "MASK", # accepts MASK
     #     },
     #   })
@@ -1145,6 +1205,7 @@ module Aws::Translate
     #   resp.applied_terminologies[0].terms #=> Array
     #   resp.applied_terminologies[0].terms[0].source_text #=> String
     #   resp.applied_terminologies[0].terms[0].target_text #=> String
+    #   resp.applied_settings.formality #=> String, one of "FORMAL", "INFORMAL"
     #   resp.applied_settings.profanity #=> String, one of "MASK"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateText AWS API Documentation
@@ -1224,7 +1285,7 @@ module Aws::Translate
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-translate'
-      context[:gem_version] = '1.42.0'
+      context[:gem_version] = '1.45.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -30,9 +30,11 @@ module Aws::Translate
     Description = Shapes::StringShape.new(name: 'Description')
     DetectedLanguageLowConfidenceException = Shapes::StructureShape.new(name: 'DetectedLanguageLowConfidenceException')
     Directionality = Shapes::StringShape.new(name: 'Directionality')
+    DisplayLanguageCode = Shapes::StringShape.new(name: 'DisplayLanguageCode')
     EncryptionKey = Shapes::StructureShape.new(name: 'EncryptionKey')
     EncryptionKeyID = Shapes::StringShape.new(name: 'EncryptionKeyID')
     EncryptionKeyType = Shapes::StringShape.new(name: 'EncryptionKeyType')
+    Formality = Shapes::StringShape.new(name: 'Formality')
     GetParallelDataRequest = Shapes::StructureShape.new(name: 'GetParallelDataRequest')
     GetParallelDataResponse = Shapes::StructureShape.new(name: 'GetParallelDataResponse')
     GetTerminologyRequest = Shapes::StructureShape.new(name: 'GetTerminologyRequest')
@@ -50,15 +52,20 @@ module Aws::Translate
     JobId = Shapes::StringShape.new(name: 'JobId')
     JobName = Shapes::StringShape.new(name: 'JobName')
     JobStatus = Shapes::StringShape.new(name: 'JobStatus')
+    Language = Shapes::StructureShape.new(name: 'Language')
     LanguageCodeString = Shapes::StringShape.new(name: 'LanguageCodeString')
     LanguageCodeStringList = Shapes::ListShape.new(name: 'LanguageCodeStringList')
+    LanguagesList = Shapes::ListShape.new(name: 'LanguagesList')
     LimitExceededException = Shapes::StructureShape.new(name: 'LimitExceededException')
+    ListLanguagesRequest = Shapes::StructureShape.new(name: 'ListLanguagesRequest')
+    ListLanguagesResponse = Shapes::StructureShape.new(name: 'ListLanguagesResponse')
     ListParallelDataRequest = Shapes::StructureShape.new(name: 'ListParallelDataRequest')
     ListParallelDataResponse = Shapes::StructureShape.new(name: 'ListParallelDataResponse')
     ListTerminologiesRequest = Shapes::StructureShape.new(name: 'ListTerminologiesRequest')
     ListTerminologiesResponse = Shapes::StructureShape.new(name: 'ListTerminologiesResponse')
     ListTextTranslationJobsRequest = Shapes::StructureShape.new(name: 'ListTextTranslationJobsRequest')
     ListTextTranslationJobsResponse = Shapes::StructureShape.new(name: 'ListTextTranslationJobsResponse')
+    LocalizedNameString = Shapes::StringShape.new(name: 'LocalizedNameString')
     Long = Shapes::IntegerShape.new(name: 'Long')
     MaxResultsInteger = Shapes::IntegerShape.new(name: 'MaxResultsInteger')
     MergeStrategy = Shapes::StringShape.new(name: 'MergeStrategy')
@@ -102,6 +109,7 @@ module Aws::Translate
     TranslateTextResponse = Shapes::StructureShape.new(name: 'TranslateTextResponse')
     TranslationSettings = Shapes::StructureShape.new(name: 'TranslationSettings')
     UnboundedLengthString = Shapes::StringShape.new(name: 'UnboundedLengthString')
+    UnsupportedDisplayLanguageCodeException = Shapes::StructureShape.new(name: 'UnsupportedDisplayLanguageCodeException')
     UnsupportedLanguagePairException = Shapes::StructureShape.new(name: 'UnsupportedLanguagePairException')
     UpdateParallelDataRequest = Shapes::StructureShape.new(name: 'UpdateParallelDataRequest')
     UpdateParallelDataResponse = Shapes::StructureShape.new(name: 'UpdateParallelDataResponse')
@@ -203,11 +211,27 @@ module Aws::Translate
     JobDetails.add_member(:input_documents_count, Shapes::ShapeRef.new(shape: Integer, location_name: "InputDocumentsCount"))
     JobDetails.struct_class = Types::JobDetails
 
+    Language.add_member(:language_name, Shapes::ShapeRef.new(shape: LocalizedNameString, required: true, location_name: "LanguageName"))
+    Language.add_member(:language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "LanguageCode"))
+    Language.struct_class = Types::Language
+
     LanguageCodeStringList.member = Shapes::ShapeRef.new(shape: LanguageCodeString)
 
+    LanguagesList.member = Shapes::ShapeRef.new(shape: Language)
+
     LimitExceededException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
     LimitExceededException.struct_class = Types::LimitExceededException
 
+    ListLanguagesRequest.add_member(:display_language_code, Shapes::ShapeRef.new(shape: DisplayLanguageCode, location_name: "DisplayLanguageCode"))
+    ListLanguagesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    ListLanguagesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResultsInteger, location_name: "MaxResults"))
+    ListLanguagesRequest.struct_class = Types::ListLanguagesRequest
+
+    ListLanguagesResponse.add_member(:languages, Shapes::ShapeRef.new(shape: LanguagesList, location_name: "Languages"))
+    ListLanguagesResponse.add_member(:display_language_code, Shapes::ShapeRef.new(shape: DisplayLanguageCode, location_name: "DisplayLanguageCode"))
+    ListLanguagesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    ListLanguagesResponse.struct_class = Types::ListLanguagesResponse
+
     ListParallelDataRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     ListParallelDataRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResultsInteger, location_name: "MaxResults"))
     ListParallelDataRequest.struct_class = Types::ListParallelDataRequest
@@ -377,9 +401,14 @@ module Aws::Translate
     TranslateTextResponse.add_member(:applied_settings, Shapes::ShapeRef.new(shape: TranslationSettings, location_name: "AppliedSettings"))
     TranslateTextResponse.struct_class = Types::TranslateTextResponse
 
+    TranslationSettings.add_member(:formality, Shapes::ShapeRef.new(shape: Formality, location_name: "Formality"))
     TranslationSettings.add_member(:profanity, Shapes::ShapeRef.new(shape: Profanity, location_name: "Profanity"))
     TranslationSettings.struct_class = Types::TranslationSettings
 
+    UnsupportedDisplayLanguageCodeException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
+    UnsupportedDisplayLanguageCodeException.add_member(:display_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, location_name: "DisplayLanguageCode"))
+    UnsupportedDisplayLanguageCodeException.struct_class = Types::UnsupportedDisplayLanguageCodeException
+
     UnsupportedLanguagePairException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
     UnsupportedLanguagePairException.add_member(:source_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, location_name: "SourceLanguageCode"))
     UnsupportedLanguagePairException.add_member(:target_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, location_name: "TargetLanguageCode"))
@@ -501,6 +530,24 @@ module Aws::Translate
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:list_languages, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListLanguages"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListLanguagesRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListLanguagesResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedDisplayLanguageCodeException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_parallel_data, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListParallelData"
         o.http_method = "POST"

data/lib/aws-sdk-translate/errors.rb

@@ -39,6 +39,7 @@ module Aws::Translate
   # * {ServiceUnavailableException}
   # * {TextSizeLimitExceededException}
   # * {TooManyRequestsException}
+  # * {UnsupportedDisplayLanguageCodeException}
   # * {UnsupportedLanguagePairException}
   #
   # Additionally, error classes are dynamically generated for service errors based on the error code
@@ -232,6 +233,26 @@ module Aws::Translate
       end
     end
 
+    class UnsupportedDisplayLanguageCodeException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::Translate::Types::UnsupportedDisplayLanguageCodeException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+
+      # @return [String]
+      def display_language_code
+        @data[:display_language_code]
+      end
+    end
+
     class UnsupportedLanguagePairException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -311,7 +311,7 @@ module Aws::Translate
     # @!attribute [rw] data_location
     #   The Amazon S3 location of the most recent parallel data input file
     #   that was successfully imported into Amazon Translate. The location
-    #   is returned as a presigned URL that has a 30 minute expiration.
+    #   is returned as a presigned URL that has a 30-minute expiration.
     #
     #   Amazon Translate doesn't scan all input files for the risk of CSV
     #   injection attacks.
@@ -331,7 +331,7 @@ module Aws::Translate
     #   warnings that were produced by your input file. This file was
     #   created when Amazon Translate attempted to create a parallel data
     #   resource. The location is returned as a presigned URL to that has a
-    #   30 minute expiration.
+    #   30-minute expiration.
     #   @return [Types::ParallelDataDataLocation]
     #
     # @!attribute [rw] latest_update_attempt_auxiliary_data_location
@@ -339,7 +339,7 @@ module Aws::Translate
     #   warnings that were produced by your input file. This file was
     #   created when Amazon Translate attempted to update a parallel data
     #   resource. The location is returned as a presigned URL to that has a
-    #   30 minute expiration.
+    #   30-minute expiration.
     #   @return [Types::ParallelDataDataLocation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/GetParallelDataResponse AWS API Documentation
@@ -369,13 +369,13 @@ module Aws::Translate
     #   The data format of the custom terminology being retrieved.
     #
     #   If you don't specify this parameter, Amazon Translate returns a
-    #   file that has the same format as the file that was imported to
-    #   create the terminology.
+    #   file with the same format as the file that was imported to create
+    #   the terminology.
     #
     #   If you specify this parameter when you retrieve a multi-directional
-    #   terminology resource, you must specify the same format as that of
-    #   the input file that was imported to create it. Otherwise, Amazon
-    #   Translate throws an error.
+    #   terminology resource, you must specify the same format as the input
+    #   file that was imported to create it. Otherwise, Amazon Translate
+    #   throws an error.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/GetTerminologyRequest AWS API Documentation
@@ -394,7 +394,7 @@ module Aws::Translate
     # @!attribute [rw] terminology_data_location
     #   The Amazon S3 location of the most recent custom terminology input
     #   file that was successfully imported into Amazon Translate. The
-    #   location is returned as a presigned URL that has a 30 minute
+    #   location is returned as a presigned URL that has a 30-minute
     #   expiration.
     #
     #   Amazon Translate doesn't scan all input files for the risk of CSV
@@ -415,7 +415,7 @@ module Aws::Translate
     #   warnings that were produced by your input file. This file was
     #   created when Amazon Translate attempted to create a terminology
     #   resource. The location is returned as a presigned URL to that has a
-    #   30 minute expiration.
+    #   30-minute expiration.
     #   @return [Types::TerminologyDataLocation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/GetTerminologyResponse AWS API Documentation
@@ -514,9 +514,18 @@ module Aws::Translate
     #       }
     #
     # @!attribute [rw] s3_uri
-    #   The URI of the AWS S3 folder that contains the input file. The
-    #   folder must be in the same Region as the API endpoint you are
-    #   calling.
+    #   The URI of the AWS S3 folder that contains the input files. Amazon
+    #   Translate translates all the files in the folder. The folder must be
+    #   in the same Region as the API endpoint you are calling.
+    #
+    #   <note markdown="1"> The URI can also point to a single input document, or it can provide
+    #   the prefix for a collection of input documents. For example. if you
+    #   use the URI `S3://bucketName/prefix` and the prefix is a single
+    #   file, Amazon Translate uses that files as input. If more than one
+    #   file begins with the prefix, Amazon Translate uses all of them as
+    #   input.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] content_type
@@ -576,8 +585,8 @@ module Aws::Translate
       include Aws::Structure
     end
 
-    # The filter specified for the operation is invalid. Specify a different
-    # filter.
+    # The filter specified for the operation is not valid. Specify a
+    # different filter.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -590,7 +599,7 @@ module Aws::Translate
       include Aws::Structure
     end
 
-    # The value of the parameter is invalid. Review the value of the
+    # The value of the parameter is not valid. Review the value of the
     # parameter you are using to correct it, and then retry your operation.
     #
     # @!attribute [rw] message
@@ -604,8 +613,8 @@ module Aws::Translate
       include Aws::Structure
     end
 
-    # The request that you made is invalid. Check your request to determine
-    # why it's invalid and then retry the request.
+    # The request that you made is not valid. Check your request to
+    # determine why it's not valid and then retry the request.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -645,6 +654,25 @@ module Aws::Translate
       include Aws::Structure
     end
 
+    # A supported language.
+    #
+    # @!attribute [rw] language_name
+    #   Language name of the supported language.
+    #   @return [String]
+    #
+    # @!attribute [rw] language_code
+    #   Language code for the supported language.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/Language AWS API Documentation
+    #
+    class Language < Struct.new(
+      :language_name,
+      :language_code)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The specified limit has been exceeded. Review your request and retry
     # it with a quantity below the stated limit.
     #
@@ -659,6 +687,63 @@ module Aws::Translate
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ListLanguagesRequest
+    #   data as a hash:
+    #
+    #       {
+    #         display_language_code: "de", # accepts de, en, es, fr, it, ja, ko, pt, zh, zh-TW
+    #         next_token: "NextToken",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] display_language_code
+    #   The language code for the language to use to display the language
+    #   names in the response. The language code is `en` by default.
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   Include the NextToken value to fetch the next group of supported
+    #   languages.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return in each response.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/ListLanguagesRequest AWS API Documentation
+    #
+    class ListLanguagesRequest < Struct.new(
+      :display_language_code,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] languages
+    #   The list of supported languages.
+    #   @return [Array<Types::Language>]
+    #
+    # @!attribute [rw] display_language_code
+    #   The language code passed in with the request.
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   If the response does not include all remaining results, use the
+    #   NextToken in the next request to fetch the next group of supported
+    #   languages.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/ListLanguagesResponse AWS API Documentation
+    #
+    class ListLanguagesResponse < Struct.new(
+      :languages,
+      :display_language_code,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListParallelDataRequest
     #   data as a hash:
     #
@@ -880,7 +965,7 @@ module Aws::Translate
     #
     # @!attribute [rw] location
     #   The Amazon S3 location of the parallel data input file. The location
-    #   is returned as a presigned URL to that has a 30 minute expiration.
+    #   is returned as a presigned URL to that has a 30-minute expiration.
     #
     #   Amazon Translate doesn't scan all input files for the risk of CSV
     #   injection attacks.
@@ -1029,8 +1114,8 @@ module Aws::Translate
       include Aws::Structure
     end
 
-    # The Amazon Translate service is temporarily unavailable. Please wait a
-    # bit and then retry your request.
+    # The Amazon Translate service is temporarily unavailable. Wait a bit
+    # and then retry your request.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -1066,6 +1151,7 @@ module Aws::Translate
     #         parallel_data_names: ["ResourceName"],
     #         client_token: "ClientTokenString", # required
     #         settings: {
+    #           formality: "FORMAL", # accepts FORMAL, INFORMAL
     #           profanity: "MASK", # accepts MASK
     #         },
     #       }
@@ -1075,7 +1161,7 @@ module Aws::Translate
     #   @return [String]
     #
     # @!attribute [rw] input_data_config
-    #   Specifies the format and S3 location of the input documents for the
+    #   Specifies the format and location of the input documents for the
     #   translation job.
     #   @return [Types::InputDataConfig]
     #
@@ -1140,7 +1226,7 @@ module Aws::Translate
     #   @return [Array<String>]
     #
     # @!attribute [rw] client_token
-    #   A unique identifier for the request. This token is auto-generated
+    #   A unique identifier for the request. This token is generated for you
     #   when using the Amazon Translate SDK.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -1149,7 +1235,8 @@ module Aws::Translate
     #
     # @!attribute [rw] settings
     #   Settings to configure your translation output, including the option
-    #   to mask profane words and phrases.
+    #   to mask profane words and phrases. `StartTextTranslationJob` does
+    #   not support the formality setting.
     #   @return [Types::TranslationSettings]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/StartTextTranslationJobRequest AWS API Documentation
@@ -1264,7 +1351,12 @@ module Aws::Translate
       include Aws::Structure
     end
 
-    # The data associated with the custom terminology.
+    # The data associated with the custom terminology. For information about
+    # the custom terminology file, see [ Creating a Custom Terminology][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/translate/latest/dg/creating-custom-terminology.html
     #
     # @note When making an API call, you may pass TerminologyData
     #   data as a hash:
@@ -1302,9 +1394,9 @@ module Aws::Translate
     #   : Any language in the terminology resource can be the source
     #     language or a target language. A single multi-directional
     #     terminology resource can be used for jobs that translate different
-    #     language pairs. For example, if the terminology contains terms in
-    #     English and Spanish, then it can be used for jobs that translate
-    #     English to Spanish and jobs that translate Spanish to English.
+    #     language pairs. For example, if the terminology contains English
+    #     and Spanish terms, it can be used for jobs that translate English
+    #     to Spanish and Spanish to English.
     #
     #   When you create a custom terminology resource without specifying the
     #   directionality, it behaves as uni-directional terminology, although
@@ -1330,8 +1422,8 @@ module Aws::Translate
     # @!attribute [rw] location
     #   The Amazon S3 location of the most recent custom terminology input
     #   file that was successfully imported into Amazon Translate. The
-    #   location is returned as a presigned URL that has a 30 minute
-    #   expiration.
+    #   location is returned as a presigned URL that has a 30-minute
+    #   expiration .
     #
     #   Amazon Translate doesn't scan all input files for the risk of CSV
     #   injection attacks.
@@ -1633,6 +1725,7 @@ module Aws::Translate
     #         source_language_code: "LanguageCodeString", # required
     #         target_language_code: "LanguageCodeString", # required
     #         settings: {
+    #           formality: "FORMAL", # accepts FORMAL, INFORMAL
     #           profanity: "MASK", # accepts MASK
     #         },
     #       }
@@ -1660,6 +1753,12 @@ module Aws::Translate
     #   specify `auto`, Amazon Translate will call [Amazon Comprehend][1] to
     #   determine the source language.
     #
+    #   <note markdown="1"> If you specify `auto`, you must send the `TranslateText` request in
+    #   a region that supports Amazon Comprehend. Otherwise, the request
+    #   returns an error indicating that autodetect is not supported.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/comprehend/latest/dg/comprehend-general.html
@@ -1672,7 +1771,8 @@ module Aws::Translate
     #
     # @!attribute [rw] settings
     #   Settings to configure your translation output, including the option
-    #   to mask profane words and phrases.
+    #   to set the formality level of the output text and the option to mask
+    #   profane words and phrases.
     #   @return [Types::TranslationSettings]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateTextRequest AWS API Documentation
@@ -1726,9 +1826,33 @@ module Aws::Translate
     #   data as a hash:
     #
     #       {
+    #         formality: "FORMAL", # accepts FORMAL, INFORMAL
     #         profanity: "MASK", # accepts MASK
     #       }
     #
+    # @!attribute [rw] formality
+    #   You can optionally specify the desired level of formality for
+    #   real-time translations to supported target languages. The formality
+    #   setting controls the level of formal language usage (also known as
+    #   [register][1]) in the translation output. You can set the value to
+    #   informal or formal. If you don't specify a value for formality, or
+    #   if the target language doesn't support formality, the translation
+    #   will ignore the formality setting.
+    #
+    #   Note that asynchronous translation jobs don't support formality. If
+    #   you provide a value for formality, the `StartTextTranslationJob` API
+    #   throws an exception (InvalidRequestException).
+    #
+    #   For target languages that support formality, see [Supported
+    #   Languages and Language Codes in the Amazon Translate Developer
+    #   Guide][2].
+    #
+    #
+    #
+    #   [1]: https://en.wikipedia.org/wiki/Register_(sociolinguistics)
+    #   [2]: https://docs.aws.amazon.com/translate/latest/dg/what-is.html
+    #   @return [String]
+    #
     # @!attribute [rw] profanity
     #   Enable the profanity setting if you want Amazon Translate to mask
     #   profane words and phrases in your translation output.
@@ -1738,24 +1862,43 @@ module Aws::Translate
     #   for each profane word or phrase, regardless of the length or number
     #   of words.
     #
-    #   Amazon Translate does not detect profanity in all of its supported
+    #   Amazon Translate doesn't detect profanity in all of its supported
     #   languages. For languages that support profanity detection, see
     #   [Supported Languages and Language Codes in the Amazon Translate
     #   Developer Guide][1].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/what-is.html#what-is-languages
+    #   [1]: https://docs.aws.amazon.com/translate/latest/dg/what-is.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslationSettings AWS API Documentation
     #
     class TranslationSettings < Struct.new(
+      :formality,
       :profanity)
       SENSITIVE = []
       include Aws::Structure
     end
 
+    # Requested display language code is not supported.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @!attribute [rw] display_language_code
+    #   Language code passed in with the request.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/UnsupportedDisplayLanguageCodeException AWS API Documentation
+    #
+    class UnsupportedDisplayLanguageCodeException < Struct.new(
+      :message,
+      :display_language_code)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Amazon Translate does not support translation from the language of the
     # source text into the requested target language. For more information,
     # see how-to-error-msg.

data/lib/aws-sdk-translate.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-translate/customizations'
 # @!group service
 module Aws::Translate
 
-  GEM_VERSION = '1.42.0'
+  GEM_VERSION = '1.45.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-translate
 version: !ruby/object:Gem::Version
-  version: 1.42.0
+  version: 1.45.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-03 00:00:00.000000000 Z
+date: 2022-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.126.0
+        version: 3.127.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.126.0
+        version: 3.127.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement