aws-sdk-translate 1.36.0 → 1.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53678386e56fb1e1160b8642565addf32016488b08ec4d9b05905fd4bfbacfbf
-  data.tar.gz: 8d8d810a3418ca42f6943341322bc25bbcf02d0cdbb532a80c737fbfb464f57b
+  metadata.gz: fc2b152c586aa4f30c6de50d8b180e83a18847ef3a4f663b174af21a97061a6e
+  data.tar.gz: ced52e7506113069374be4851185cd751c58ff28a122b646f0ff38640ac2013f
 SHA512:
-  metadata.gz: 5538a4d4ba834b321a025983a5fcdf0e38fc9079699c945f3bb9b2525a04fc0413c0e608dd0c83133be5f9dc6f23f220e1860c196c3a6c4586ae015fbb9ed5d9
-  data.tar.gz: a9e2bada7940f6cf6145d3c5b9dfc6a6a69ca9a193bd65e1e3d3ee79876aa90ea9a2364b9b79e7d359f8edbdd056e6d9f490bc33c23ccc6f737f18d7a9bf4f7b
+  metadata.gz: cead605e2540006c815e656b1a73b5401f1701c846fefdb2176cc5c2164f9fc8a3ab72c9c736bf4917571535a615f6d9659086544a810d15b9c4b674b3e300d0
+  data.tar.gz: e6168ec88405f18d90b6306f71fb8e0c0509673c79c7d58faa86be2ccf642a83c3c0ce22b03283bd2c1fbda0e45afbfa5f1365a46d59a0eea91cf41f309b4d14

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.40.0 (2021-11-30)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.39.0 (2021-11-24)
+------------------
+
+* Feature - This release enables customers to use translation settings to mask profane words and phrases in their translation output.
+
+1.38.0 (2021-11-11)
+------------------
+
+* Feature - This release enables customers to import Multi-Directional Custom Terminology and use Multi-Directional Custom Terminology in both real-time translation and asynchronous batch translation.
+
+1.37.0 (2021-11-05)
+------------------
+
+* Feature - This release enable customers to use their own KMS keys to encrypt output files when they submit a batch transform job.
+
 1.36.0 (2021-11-04)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.36.0
+1.40.0

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

@@ -119,7 +119,9 @@ module Aws::Translate
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
     #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
-    #       enable retries and extended timeouts.
+    #       enable retries and extended timeouts. Instance profile credential
+    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
+    #       to true.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -347,10 +349,10 @@ module Aws::Translate
     # @!group API Operations
 
     # Creates a parallel data resource in Amazon Translate by importing an
-    # input file from Amazon S3. Parallel data files contain examples of
-    # source phrases and their translations from your translation memory. By
-    # adding parallel data, you can influence the style, tone, and word
-    # choice in your translation output.
+    # input file from Amazon S3. Parallel data files contain examples that
+    # show how you want segments of text to be translated. By adding
+    # parallel data, you can influence the style, tone, and word choice in
+    # your translation output.
     #
     # @option params [required, String] :name
     #   A custom name for the parallel data resource in Amazon Translate. You
@@ -460,7 +462,7 @@ module Aws::Translate
       req.send_request(options)
     end
 
-    # Gets the properties associated with an asycnhronous batch translation
+    # Gets the properties associated with an asynchronous batch translation
     # job including name, ID, status, source and target languages,
     # input/output S3 buckets, and so on.
     #
@@ -500,7 +502,10 @@ module Aws::Translate
     #   resp.text_translation_job_properties.input_data_config.s3_uri #=> String
     #   resp.text_translation_job_properties.input_data_config.content_type #=> String
     #   resp.text_translation_job_properties.output_data_config.s3_uri #=> String
+    #   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.profanity #=> String, one of "MASK"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/DescribeTextTranslationJob AWS API Documentation
     #
@@ -572,20 +577,29 @@ module Aws::Translate
     # @option params [required, String] :name
     #   The name of the custom terminology being retrieved.
     #
-    # @option params [required, String] :terminology_data_format
-    #   The data format of the custom terminology being retrieved, either CSV
-    #   or TMX.
+    # @option params [String] :terminology_data_format
+    #   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.
+    #
+    #   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.
     #
     # @return [Types::GetTerminologyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetTerminologyResponse#terminology_properties #terminology_properties} => Types::TerminologyProperties
     #   * {Types::GetTerminologyResponse#terminology_data_location #terminology_data_location} => Types::TerminologyDataLocation
+    #   * {Types::GetTerminologyResponse#auxiliary_data_location #auxiliary_data_location} => Types::TerminologyDataLocation
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_terminology({
     #     name: "ResourceName", # required
-    #     terminology_data_format: "CSV", # required, accepts CSV, TMX
+    #     terminology_data_format: "CSV", # accepts CSV, TMX, TSV
     #   })
     #
     # @example Response structure
@@ -602,8 +616,14 @@ module Aws::Translate
     #   resp.terminology_properties.term_count #=> Integer
     #   resp.terminology_properties.created_at #=> Time
     #   resp.terminology_properties.last_updated_at #=> Time
+    #   resp.terminology_properties.directionality #=> String, one of "UNI", "MULTI"
+    #   resp.terminology_properties.message #=> String
+    #   resp.terminology_properties.skipped_term_count #=> Integer
+    #   resp.terminology_properties.format #=> String, one of "CSV", "TMX", "TSV"
     #   resp.terminology_data_location.repository_type #=> String
     #   resp.terminology_data_location.location #=> String
+    #   resp.auxiliary_data_location.repository_type #=> String
+    #   resp.auxiliary_data_location.location #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/GetTerminology AWS API Documentation
     #
@@ -647,6 +667,7 @@ module Aws::Translate
     # @return [Types::ImportTerminologyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ImportTerminologyResponse#terminology_properties #terminology_properties} => Types::TerminologyProperties
+    #   * {Types::ImportTerminologyResponse#auxiliary_data_location #auxiliary_data_location} => Types::TerminologyDataLocation
     #
     # @example Request syntax with placeholder values
     #
@@ -656,7 +677,8 @@ module Aws::Translate
     #     description: "Description",
     #     terminology_data: { # required
     #       file: "data", # required
-    #       format: "CSV", # required, accepts CSV, TMX
+    #       format: "CSV", # required, accepts CSV, TMX, TSV
+    #       directionality: "UNI", # accepts UNI, MULTI
     #     },
     #     encryption_key: {
     #       type: "KMS", # required, accepts KMS
@@ -678,6 +700,12 @@ module Aws::Translate
     #   resp.terminology_properties.term_count #=> Integer
     #   resp.terminology_properties.created_at #=> Time
     #   resp.terminology_properties.last_updated_at #=> Time
+    #   resp.terminology_properties.directionality #=> String, one of "UNI", "MULTI"
+    #   resp.terminology_properties.message #=> String
+    #   resp.terminology_properties.skipped_term_count #=> Integer
+    #   resp.terminology_properties.format #=> String, one of "CSV", "TMX", "TSV"
+    #   resp.auxiliary_data_location.repository_type #=> String
+    #   resp.auxiliary_data_location.location #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/ImportTerminology AWS API Documentation
     #
@@ -784,6 +812,10 @@ module Aws::Translate
     #   resp.terminology_properties_list[0].term_count #=> Integer
     #   resp.terminology_properties_list[0].created_at #=> Time
     #   resp.terminology_properties_list[0].last_updated_at #=> Time
+    #   resp.terminology_properties_list[0].directionality #=> String, one of "UNI", "MULTI"
+    #   resp.terminology_properties_list[0].message #=> String
+    #   resp.terminology_properties_list[0].skipped_term_count #=> Integer
+    #   resp.terminology_properties_list[0].format #=> String, one of "CSV", "TMX", "TSV"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/ListTerminologies AWS API Documentation
@@ -851,7 +883,10 @@ module Aws::Translate
     #   resp.text_translation_job_properties_list[0].input_data_config.s3_uri #=> String
     #   resp.text_translation_job_properties_list[0].input_data_config.content_type #=> String
     #   resp.text_translation_job_properties_list[0].output_data_config.s3_uri #=> String
+    #   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.profanity #=> String, one of "MASK"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/ListTextTranslationJobs AWS API Documentation
@@ -890,7 +925,7 @@ module Aws::Translate
     # @option params [required, String] :data_access_role_arn
     #   The Amazon Resource Name (ARN) of an AWS Identity Access and
     #   Management (IAM) role that grants Amazon Translate read access to your
-    #   input data. For more nformation, see identity-and-access-management.
+    #   input data. For more information, see identity-and-access-management.
     #
     # @option params [required, String] :source_language_code
     #   The language code of the input language. For a list of language codes,
@@ -903,13 +938,39 @@ module Aws::Translate
     #   The language code of the output language.
     #
     # @option params [Array<String>] :terminology_names
-    #   The name of the terminology to use in the batch translation job. For a
-    #   list of available terminologies, use the ListTerminologies operation.
+    #   The name of a custom terminology resource to add to the translation
+    #   job. This resource lists examples source terms and the desired
+    #   translation for each term.
+    #
+    #   This parameter accepts only one custom terminology resource.
+    #
+    #   For a list of available custom terminology resources, use the
+    #   ListTerminologies operation.
+    #
+    #   For more information, see how-custom-terminology.
     #
     # @option params [Array<String>] :parallel_data_names
-    #   The names of the parallel data resources to use in the batch
-    #   translation job. For a list of available parallel data resources, use
-    #   the ListParallelData operation.
+    #   The name of a parallel data resource to add to the translation job.
+    #   This resource consists of examples that show how you want segments of
+    #   text to be translated. When you add parallel data to a translation
+    #   job, you create an *Active Custom Translation* job.
+    #
+    #   This parameter accepts only one parallel data resource.
+    #
+    #   <note markdown="1"> Active Custom Translation jobs are priced at a higher rate than other
+    #   jobs that don't use parallel data. For more information, see [Amazon
+    #   Translate pricing][1].
+    #
+    #    </note>
+    #
+    #   For a list of available parallel data resources, use the
+    #   ListParallelData operation.
+    #
+    #   For more information, see customizing-translations-parallel-data.
+    #
+    #
+    #
+    #   [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
@@ -918,6 +979,10 @@ module Aws::Translate
     #   **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.
+    #
     # @return [Types::StartTextTranslationJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartTextTranslationJobResponse#job_id #job_id} => String
@@ -933,6 +998,10 @@ module Aws::Translate
     #     },
     #     output_data_config: { # required
     #       s3_uri: "S3Uri", # required
+    #       encryption_key: {
+    #         type: "KMS", # required, accepts KMS
+    #         id: "EncryptionKeyID", # required
+    #       },
     #     },
     #     data_access_role_arn: "IamRoleArn", # required
     #     source_language_code: "LanguageCodeString", # required
@@ -940,6 +1009,9 @@ module Aws::Translate
     #     terminology_names: ["ResourceName"],
     #     parallel_data_names: ["ResourceName"],
     #     client_token: "ClientTokenString", # required
+    #     settings: {
+    #       profanity: "MASK", # accepts MASK
+    #     },
     #   })
     #
     # @example Response structure
@@ -1028,12 +1100,17 @@ module Aws::Translate
     #   The language code requested for the language of the target text. The
     #   language must be a language supported by Amazon Translate.
     #
+    # @option params [Types::TranslationSettings] :settings
+    #   Settings to configure your translation output, including the option to
+    #   mask profane words and phrases.
+    #
     # @return [Types::TranslateTextResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::TranslateTextResponse#translated_text #translated_text} => String
     #   * {Types::TranslateTextResponse#source_language_code #source_language_code} => String
     #   * {Types::TranslateTextResponse#target_language_code #target_language_code} => String
     #   * {Types::TranslateTextResponse#applied_terminologies #applied_terminologies} => Array&lt;Types::AppliedTerminology&gt;
+    #   * {Types::TranslateTextResponse#applied_settings #applied_settings} => Types::TranslationSettings
     #
     # @example Request syntax with placeholder values
     #
@@ -1042,6 +1119,9 @@ module Aws::Translate
     #     terminology_names: ["ResourceName"],
     #     source_language_code: "LanguageCodeString", # required
     #     target_language_code: "LanguageCodeString", # required
+    #     settings: {
+    #       profanity: "MASK", # accepts MASK
+    #     },
     #   })
     #
     # @example Response structure
@@ -1054,6 +1134,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.profanity #=> String, one of "MASK"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateText AWS API Documentation
     #
@@ -1132,7 +1213,7 @@ module Aws::Translate
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-translate'
-      context[:gem_version] = '1.36.0'
+      context[:gem_version] = '1.40.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -29,6 +29,7 @@ module Aws::Translate
     DescribeTextTranslationJobResponse = Shapes::StructureShape.new(name: 'DescribeTextTranslationJobResponse')
     Description = Shapes::StringShape.new(name: 'Description')
     DetectedLanguageLowConfidenceException = Shapes::StructureShape.new(name: 'DetectedLanguageLowConfidenceException')
+    Directionality = Shapes::StringShape.new(name: 'Directionality')
     EncryptionKey = Shapes::StructureShape.new(name: 'EncryptionKey')
     EncryptionKeyID = Shapes::StringShape.new(name: 'EncryptionKeyID')
     EncryptionKeyType = Shapes::StringShape.new(name: 'EncryptionKeyType')
@@ -70,6 +71,7 @@ module Aws::Translate
     ParallelDataProperties = Shapes::StructureShape.new(name: 'ParallelDataProperties')
     ParallelDataPropertiesList = Shapes::ListShape.new(name: 'ParallelDataPropertiesList')
     ParallelDataStatus = Shapes::StringShape.new(name: 'ParallelDataStatus')
+    Profanity = Shapes::StringShape.new(name: 'Profanity')
     ResourceName = Shapes::StringShape.new(name: 'ResourceName')
     ResourceNameList = Shapes::ListShape.new(name: 'ResourceNameList')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
@@ -98,6 +100,7 @@ module Aws::Translate
     TooManyRequestsException = Shapes::StructureShape.new(name: 'TooManyRequestsException')
     TranslateTextRequest = Shapes::StructureShape.new(name: 'TranslateTextRequest')
     TranslateTextResponse = Shapes::StructureShape.new(name: 'TranslateTextResponse')
+    TranslationSettings = Shapes::StructureShape.new(name: 'TranslationSettings')
     UnboundedLengthString = Shapes::StringShape.new(name: 'UnboundedLengthString')
     UnsupportedLanguagePairException = Shapes::StructureShape.new(name: 'UnsupportedLanguagePairException')
     UpdateParallelDataRequest = Shapes::StructureShape.new(name: 'UpdateParallelDataRequest')
@@ -160,11 +163,12 @@ module Aws::Translate
     GetParallelDataResponse.struct_class = Types::GetParallelDataResponse
 
     GetTerminologyRequest.add_member(:name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location_name: "Name"))
-    GetTerminologyRequest.add_member(:terminology_data_format, Shapes::ShapeRef.new(shape: TerminologyDataFormat, required: true, location_name: "TerminologyDataFormat"))
+    GetTerminologyRequest.add_member(:terminology_data_format, Shapes::ShapeRef.new(shape: TerminologyDataFormat, location_name: "TerminologyDataFormat"))
     GetTerminologyRequest.struct_class = Types::GetTerminologyRequest
 
     GetTerminologyResponse.add_member(:terminology_properties, Shapes::ShapeRef.new(shape: TerminologyProperties, location_name: "TerminologyProperties"))
     GetTerminologyResponse.add_member(:terminology_data_location, Shapes::ShapeRef.new(shape: TerminologyDataLocation, location_name: "TerminologyDataLocation"))
+    GetTerminologyResponse.add_member(:auxiliary_data_location, Shapes::ShapeRef.new(shape: TerminologyDataLocation, location_name: "AuxiliaryDataLocation"))
     GetTerminologyResponse.struct_class = Types::GetTerminologyResponse
 
     ImportTerminologyRequest.add_member(:name, Shapes::ShapeRef.new(shape: ResourceName, required: true, location_name: "Name"))
@@ -175,6 +179,7 @@ module Aws::Translate
     ImportTerminologyRequest.struct_class = Types::ImportTerminologyRequest
 
     ImportTerminologyResponse.add_member(:terminology_properties, Shapes::ShapeRef.new(shape: TerminologyProperties, location_name: "TerminologyProperties"))
+    ImportTerminologyResponse.add_member(:auxiliary_data_location, Shapes::ShapeRef.new(shape: TerminologyDataLocation, location_name: "AuxiliaryDataLocation"))
     ImportTerminologyResponse.struct_class = Types::ImportTerminologyResponse
 
     InputDataConfig.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
@@ -229,6 +234,7 @@ module Aws::Translate
     ListTextTranslationJobsResponse.struct_class = Types::ListTextTranslationJobsResponse
 
     OutputDataConfig.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
+    OutputDataConfig.add_member(:encryption_key, Shapes::ShapeRef.new(shape: EncryptionKey, location_name: "EncryptionKey"))
     OutputDataConfig.struct_class = Types::OutputDataConfig
 
     ParallelDataConfig.add_member(:s3_uri, Shapes::ShapeRef.new(shape: S3Uri, required: true, location_name: "S3Uri"))
@@ -277,6 +283,7 @@ module Aws::Translate
     StartTextTranslationJobRequest.add_member(:terminology_names, Shapes::ShapeRef.new(shape: ResourceNameList, location_name: "TerminologyNames"))
     StartTextTranslationJobRequest.add_member(:parallel_data_names, Shapes::ShapeRef.new(shape: ResourceNameList, location_name: "ParallelDataNames"))
     StartTextTranslationJobRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientTokenString, required: true, location_name: "ClientToken", metadata: {"idempotencyToken"=>true}))
+    StartTextTranslationJobRequest.add_member(:settings, Shapes::ShapeRef.new(shape: TranslationSettings, location_name: "Settings"))
     StartTextTranslationJobRequest.struct_class = Types::StartTextTranslationJobRequest
 
     StartTextTranslationJobResponse.add_member(:job_id, Shapes::ShapeRef.new(shape: JobId, location_name: "JobId"))
@@ -300,6 +307,7 @@ module Aws::Translate
 
     TerminologyData.add_member(:file, Shapes::ShapeRef.new(shape: TerminologyFile, required: true, location_name: "File"))
     TerminologyData.add_member(:format, Shapes::ShapeRef.new(shape: TerminologyDataFormat, required: true, location_name: "Format"))
+    TerminologyData.add_member(:directionality, Shapes::ShapeRef.new(shape: Directionality, location_name: "Directionality"))
     TerminologyData.struct_class = Types::TerminologyData
 
     TerminologyDataLocation.add_member(:repository_type, Shapes::ShapeRef.new(shape: String, required: true, location_name: "RepositoryType"))
@@ -316,6 +324,10 @@ module Aws::Translate
     TerminologyProperties.add_member(:term_count, Shapes::ShapeRef.new(shape: Integer, location_name: "TermCount"))
     TerminologyProperties.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreatedAt"))
     TerminologyProperties.add_member(:last_updated_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastUpdatedAt"))
+    TerminologyProperties.add_member(:directionality, Shapes::ShapeRef.new(shape: Directionality, location_name: "Directionality"))
+    TerminologyProperties.add_member(:message, Shapes::ShapeRef.new(shape: UnboundedLengthString, location_name: "Message"))
+    TerminologyProperties.add_member(:skipped_term_count, Shapes::ShapeRef.new(shape: Integer, location_name: "SkippedTermCount"))
+    TerminologyProperties.add_member(:format, Shapes::ShapeRef.new(shape: TerminologyDataFormat, location_name: "Format"))
     TerminologyProperties.struct_class = Types::TerminologyProperties
 
     TerminologyPropertiesList.member = Shapes::ShapeRef.new(shape: TerminologyProperties)
@@ -343,6 +355,7 @@ module Aws::Translate
     TextTranslationJobProperties.add_member(:input_data_config, Shapes::ShapeRef.new(shape: InputDataConfig, location_name: "InputDataConfig"))
     TextTranslationJobProperties.add_member(:output_data_config, Shapes::ShapeRef.new(shape: OutputDataConfig, location_name: "OutputDataConfig"))
     TextTranslationJobProperties.add_member(:data_access_role_arn, Shapes::ShapeRef.new(shape: IamRoleArn, location_name: "DataAccessRoleArn"))
+    TextTranslationJobProperties.add_member(:settings, Shapes::ShapeRef.new(shape: TranslationSettings, location_name: "Settings"))
     TextTranslationJobProperties.struct_class = Types::TextTranslationJobProperties
 
     TextTranslationJobPropertiesList.member = Shapes::ShapeRef.new(shape: TextTranslationJobProperties)
@@ -354,14 +367,19 @@ module Aws::Translate
     TranslateTextRequest.add_member(:terminology_names, Shapes::ShapeRef.new(shape: ResourceNameList, location_name: "TerminologyNames"))
     TranslateTextRequest.add_member(:source_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "SourceLanguageCode"))
     TranslateTextRequest.add_member(:target_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "TargetLanguageCode"))
+    TranslateTextRequest.add_member(:settings, Shapes::ShapeRef.new(shape: TranslationSettings, location_name: "Settings"))
     TranslateTextRequest.struct_class = Types::TranslateTextRequest
 
     TranslateTextResponse.add_member(:translated_text, Shapes::ShapeRef.new(shape: String, required: true, location_name: "TranslatedText"))
     TranslateTextResponse.add_member(:source_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "SourceLanguageCode"))
     TranslateTextResponse.add_member(:target_language_code, Shapes::ShapeRef.new(shape: LanguageCodeString, required: true, location_name: "TargetLanguageCode"))
     TranslateTextResponse.add_member(:applied_terminologies, Shapes::ShapeRef.new(shape: AppliedTerminologyList, location_name: "AppliedTerminologies"))
+    TranslateTextResponse.add_member(:applied_settings, Shapes::ShapeRef.new(shape: TranslationSettings, location_name: "AppliedSettings"))
     TranslateTextResponse.struct_class = Types::TranslateTextResponse
 
+    TranslationSettings.add_member(:profanity, Shapes::ShapeRef.new(shape: Profanity, location_name: "Profanity"))
+    TranslationSettings.struct_class = Types::TranslationSettings
+
     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"))
@@ -545,6 +563,7 @@ module Aws::Translate
         o.errors << Shapes::ShapeRef.new(shape: UnsupportedLanguagePairException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 

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

@@ -266,13 +266,13 @@ module Aws::Translate
     #       }
     #
     # @!attribute [rw] type
-    #   The type of encryption key used by Amazon Translate to encrypt
-    #   custom terminologies.
+    #   The type of encryption key used by Amazon Translate to encrypt this
+    #   object.
     #   @return [String]
     #
     # @!attribute [rw] id
     #   The Amazon Resource Name (ARN) of the encryption key being used to
-    #   encrypt the custom terminology.
+    #   encrypt this object.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/EncryptionKey AWS API Documentation
@@ -309,9 +309,21 @@ module Aws::Translate
     #   @return [Types::ParallelDataProperties]
     #
     # @!attribute [rw] data_location
-    #   The 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.
+    #   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.
+    #
+    #   Amazon Translate doesn't scan all input files for the risk of CSV
+    #   injection attacks.
+    #
+    #    CSV injection occurs when a .csv or .tsv file is altered so that a
+    #   record contains malicious code. The record begins with a special
+    #   character, such as =, +, -, or @. When the file is opened in a
+    #   spreadsheet program, the program might interpret the record as a
+    #   formula and run the code within it.
+    #
+    #    Before you download an input file from Amazon S3, ensure that you
+    #   recognize the file and trust its creator.
     #   @return [Types::ParallelDataDataLocation]
     #
     # @!attribute [rw] auxiliary_data_location
@@ -346,7 +358,7 @@ module Aws::Translate
     #
     #       {
     #         name: "ResourceName", # required
-    #         terminology_data_format: "CSV", # required, accepts CSV, TMX
+    #         terminology_data_format: "CSV", # accepts CSV, TMX, TSV
     #       }
     #
     # @!attribute [rw] name
@@ -354,8 +366,16 @@ module Aws::Translate
     #   @return [String]
     #
     # @!attribute [rw] terminology_data_format
-    #   The data format of the custom terminology being retrieved, either
-    #   CSV or TMX.
+    #   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.
+    #
+    #   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.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/GetTerminologyRequest AWS API Documentation
@@ -372,16 +392,38 @@ module Aws::Translate
     #   @return [Types::TerminologyProperties]
     #
     # @!attribute [rw] terminology_data_location
-    #   The data location of the custom terminology being retrieved. The
-    #   custom terminology file is returned in a presigned url that has a 30
-    #   minute expiration.
+    #   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.
+    #
+    #   Amazon Translate doesn't scan all input files for the risk of CSV
+    #   injection attacks.
+    #
+    #    CSV injection occurs when a .csv or .tsv file is altered so that a
+    #   record contains malicious code. The record begins with a special
+    #   character, such as =, +, -, or @. When the file is opened in a
+    #   spreadsheet program, the program might interpret the record as a
+    #   formula and run the code within it.
+    #
+    #    Before you download an input file from Amazon S3, ensure that you
+    #   recognize the file and trust its creator.
+    #   @return [Types::TerminologyDataLocation]
+    #
+    # @!attribute [rw] auxiliary_data_location
+    #   The Amazon S3 location of a file that provides any errors or
+    #   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.
     #   @return [Types::TerminologyDataLocation]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/GetTerminologyResponse AWS API Documentation
     #
     class GetTerminologyResponse < Struct.new(
       :terminology_properties,
-      :terminology_data_location)
+      :terminology_data_location,
+      :auxiliary_data_location)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -395,7 +437,8 @@ module Aws::Translate
     #         description: "Description",
     #         terminology_data: { # required
     #           file: "data", # required
-    #           format: "CSV", # required, accepts CSV, TMX
+    #           format: "CSV", # required, accepts CSV, TMX, TSV
+    #           directionality: "UNI", # accepts UNI, MULTI
     #         },
     #         encryption_key: {
     #           type: "KMS", # required, accepts KMS
@@ -442,10 +485,19 @@ module Aws::Translate
     #   The properties of the custom terminology being imported.
     #   @return [Types::TerminologyProperties]
     #
+    # @!attribute [rw] auxiliary_data_location
+    #   The Amazon S3 location of a file that provides any errors or
+    #   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.
+    #   @return [Types::TerminologyDataLocation]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/ImportTerminologyResponse AWS API Documentation
     #
     class ImportTerminologyResponse < Struct.new(
-      :terminology_properties)
+      :terminology_properties,
+      :auxiliary_data_location)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -491,6 +543,10 @@ module Aws::Translate
     #     The input data consists of one or more Excel Workbook files
     #     (.xlsx).
     #
+    #   * `application/x-xliff+xml`\: The input data consists of one or more
+    #     XML Localization Interchange File Format (XLIFF) files (.xlf).
+    #     Amazon Translate supports only XLIFF version 1.2.
+    #
     #   If you structure your input data as HTML, ensure that you set this
     #   parameter to `text/html`. By doing so, you cut costs by limiting the
     #   translation to the contents of the `html` element in each file.
@@ -741,7 +797,7 @@ module Aws::Translate
     #   @return [Array<Types::TextTranslationJobProperties>]
     #
     # @!attribute [rw] next_token
-    #   The token to use to retreive the next page of results. This value is
+    #   The token to use to retrieve the next page of results. This value is
     #   `null` when there are no more results to return.
     #   @return [String]
     #
@@ -761,6 +817,10 @@ module Aws::Translate
     #
     #       {
     #         s3_uri: "S3Uri", # required
+    #         encryption_key: {
+    #           type: "KMS", # required, accepts KMS
+    #           id: "EncryptionKeyID", # required
+    #         },
     #       }
     #
     # @!attribute [rw] s3_uri
@@ -769,10 +829,15 @@ module Aws::Translate
     #   you are calling.
     #   @return [String]
     #
+    # @!attribute [rw] encryption_key
+    #   The encryption key used to encrypt this object.
+    #   @return [Types::EncryptionKey]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/OutputDataConfig AWS API Documentation
     #
     class OutputDataConfig < Struct.new(
-      :s3_uri)
+      :s3_uri,
+      :encryption_key)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -816,6 +881,18 @@ 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.
+    #
+    #   Amazon Translate doesn't scan all input files for the risk of CSV
+    #   injection attacks.
+    #
+    #    CSV injection occurs when a .csv or .tsv file is altered so that a
+    #   record contains malicious code. The record begins with a special
+    #   character, such as =, +, -, or @. When the file is opened in a
+    #   spreadsheet program, the program might interpret the record as a
+    #   formula and run the code within it.
+    #
+    #    Before you download an input file from Amazon S3, ensure that you
+    #   recognize the file and trust its creator.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/ParallelDataDataLocation AWS API Documentation
@@ -977,6 +1054,10 @@ module Aws::Translate
     #         },
     #         output_data_config: { # required
     #           s3_uri: "S3Uri", # required
+    #           encryption_key: {
+    #             type: "KMS", # required, accepts KMS
+    #             id: "EncryptionKeyID", # required
+    #           },
     #         },
     #         data_access_role_arn: "IamRoleArn", # required
     #         source_language_code: "LanguageCodeString", # required
@@ -984,6 +1065,9 @@ module Aws::Translate
     #         terminology_names: ["ResourceName"],
     #         parallel_data_names: ["ResourceName"],
     #         client_token: "ClientTokenString", # required
+    #         settings: {
+    #           profanity: "MASK", # accepts MASK
+    #         },
     #       }
     #
     # @!attribute [rw] job_name
@@ -1002,7 +1086,7 @@ module Aws::Translate
     # @!attribute [rw] data_access_role_arn
     #   The Amazon Resource Name (ARN) of an AWS Identity Access and
     #   Management (IAM) role that grants Amazon Translate read access to
-    #   your input data. For more nformation, see
+    #   your input data. For more information, see
     #   identity-and-access-management.
     #   @return [String]
     #
@@ -1019,15 +1103,40 @@ module Aws::Translate
     #   @return [Array<String>]
     #
     # @!attribute [rw] terminology_names
-    #   The name of the terminology to use in the batch translation job. For
-    #   a list of available terminologies, use the ListTerminologies
-    #   operation.
+    #   The name of a custom terminology resource to add to the translation
+    #   job. This resource lists examples source terms and the desired
+    #   translation for each term.
+    #
+    #   This parameter accepts only one custom terminology resource.
+    #
+    #   For a list of available custom terminology resources, use the
+    #   ListTerminologies operation.
+    #
+    #   For more information, see how-custom-terminology.
     #   @return [Array<String>]
     #
     # @!attribute [rw] parallel_data_names
-    #   The names of the parallel data resources to use in the batch
-    #   translation job. For a list of available parallel data resources,
-    #   use the ListParallelData operation.
+    #   The name of a parallel data resource to add to the translation job.
+    #   This resource consists of examples that show how you want segments
+    #   of text to be translated. When you add parallel data to a
+    #   translation job, you create an *Active Custom Translation* job.
+    #
+    #   This parameter accepts only one parallel data resource.
+    #
+    #   <note markdown="1"> Active Custom Translation jobs are priced at a higher rate than
+    #   other jobs that don't use parallel data. For more information, see
+    #   [Amazon Translate pricing][1].
+    #
+    #    </note>
+    #
+    #   For a list of available parallel data resources, use the
+    #   ListParallelData operation.
+    #
+    #   For more information, see customizing-translations-parallel-data.
+    #
+    #
+    #
+    #   [1]: http://aws.amazon.com/translate/pricing/
     #   @return [Array<String>]
     #
     # @!attribute [rw] client_token
@@ -1038,6 +1147,11 @@ module Aws::Translate
     #   not need to pass this option.
     #   @return [String]
     #
+    # @!attribute [rw] settings
+    #   Settings to configure your translation output, including the option
+    #   to mask profane words and phrases.
+    #   @return [Types::TranslationSettings]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/StartTextTranslationJobRequest AWS API Documentation
     #
     class StartTextTranslationJobRequest < Struct.new(
@@ -1049,7 +1163,8 @@ module Aws::Translate
       :target_language_codes,
       :terminology_names,
       :parallel_data_names,
-      :client_token)
+      :client_token,
+      :settings)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1156,7 +1271,8 @@ module Aws::Translate
     #
     #       {
     #         file: "data", # required
-    #         format: "CSV", # required, accepts CSV, TMX
+    #         format: "CSV", # required, accepts CSV, TMX, TSV
+    #         directionality: "UNI", # accepts UNI, MULTI
     #       }
     #
     # @!attribute [rw] file
@@ -1167,14 +1283,40 @@ module Aws::Translate
     #   @return [String]
     #
     # @!attribute [rw] format
-    #   The data format of the custom terminology. Either CSV or TMX.
+    #   The data format of the custom terminology.
+    #   @return [String]
+    #
+    # @!attribute [rw] directionality
+    #   The directionality of your terminology resource indicates whether it
+    #   has one source language (uni-directional) or multiple
+    #   (multi-directional).
+    #
+    #   UNI
+    #
+    #   : The terminology resource has one source language (for example, the
+    #     first column in a CSV file), and all of its other languages are
+    #     target languages.
+    #
+    #   MULTI
+    #
+    #   : 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.
+    #
+    #   When you create a custom terminology resource without specifying the
+    #   directionality, it behaves as uni-directional terminology, although
+    #   this parameter will have a null value.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TerminologyData AWS API Documentation
     #
     class TerminologyData < Struct.new(
       :file,
-      :format)
+      :format,
+      :directionality)
       SENSITIVE = [:file]
       include Aws::Structure
     end
@@ -1186,7 +1328,22 @@ module Aws::Translate
     #   @return [String]
     #
     # @!attribute [rw] location
-    #   The location of the custom terminology data.
+    #   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.
+    #
+    #   Amazon Translate doesn't scan all input files for the risk of CSV
+    #   injection attacks.
+    #
+    #    CSV injection occurs when a .csv or .tsv file is altered so that a
+    #   record contains malicious code. The record begins with a special
+    #   character, such as =, +, -, or @. When the file is opened in a
+    #   spreadsheet program, the program might interpret the record as a
+    #   formula and run the code within it.
+    #
+    #    Before you download an input file from Amazon S3, ensure that you
+    #   recognize the file and trust its creator.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TerminologyDataLocation AWS API Documentation
@@ -1219,8 +1376,8 @@ module Aws::Translate
     #
     # @!attribute [rw] target_language_codes
     #   The language codes for the target languages available with the
-    #   custom terminology file. All possible target languages are returned
-    #   in array.
+    #   custom terminology resource. All possible target languages are
+    #   returned in array.
     #   @return [Array<String>]
     #
     # @!attribute [rw] encryption_key
@@ -1245,6 +1402,37 @@ module Aws::Translate
     #   the timestamp.
     #   @return [Time]
     #
+    # @!attribute [rw] directionality
+    #   The directionality of your terminology resource indicates whether it
+    #   has one source language (uni-directional) or multiple
+    #   (multi-directional).
+    #
+    #   UNI
+    #
+    #   : The terminology resource has one source language (the first column
+    #     in a CSV file), and all of its other languages are target
+    #     languages.
+    #
+    #   MULTI
+    #
+    #   : Any language in the terminology resource can be the source
+    #     language.
+    #   @return [String]
+    #
+    # @!attribute [rw] message
+    #   Additional information from Amazon Translate about the terminology
+    #   resource.
+    #   @return [String]
+    #
+    # @!attribute [rw] skipped_term_count
+    #   The number of terms in the input file that Amazon Translate skipped
+    #   when you created or updated the terminology resource.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] format
+    #   The format of the custom terminology input file.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TerminologyProperties AWS API Documentation
     #
     class TerminologyProperties < Struct.new(
@@ -1257,7 +1445,11 @@ module Aws::Translate
       :size_bytes,
       :term_count,
       :created_at,
-      :last_updated_at)
+      :last_updated_at,
+      :directionality,
+      :message,
+      :skipped_term_count,
+      :format)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1364,7 +1556,7 @@ module Aws::Translate
     #   @return [Array<String>]
     #
     # @!attribute [rw] message
-    #   An explanation of any errors that may have occured during the
+    #   An explanation of any errors that may have occurred during the
     #   translation job.
     #   @return [String]
     #
@@ -1392,6 +1584,10 @@ module Aws::Translate
     #   the job's input data.
     #   @return [String]
     #
+    # @!attribute [rw] settings
+    #   Settings that configure the translation output.
+    #   @return [Types::TranslationSettings]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TextTranslationJobProperties AWS API Documentation
     #
     class TextTranslationJobProperties < Struct.new(
@@ -1408,7 +1604,8 @@ module Aws::Translate
       :end_time,
       :input_data_config,
       :output_data_config,
-      :data_access_role_arn)
+      :data_access_role_arn,
+      :settings)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1435,6 +1632,9 @@ module Aws::Translate
     #         terminology_names: ["ResourceName"],
     #         source_language_code: "LanguageCodeString", # required
     #         target_language_code: "LanguageCodeString", # required
+    #         settings: {
+    #           profanity: "MASK", # accepts MASK
+    #         },
     #       }
     #
     # @!attribute [rw] text
@@ -1470,13 +1670,19 @@ module Aws::Translate
     #   language must be a language supported by Amazon Translate.
     #   @return [String]
     #
+    # @!attribute [rw] settings
+    #   Settings to configure your translation output, including 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
     #
     class TranslateTextRequest < Struct.new(
       :text,
       :terminology_names,
       :source_language_code,
-      :target_language_code)
+      :target_language_code,
+      :settings)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1498,13 +1704,54 @@ module Aws::Translate
     #   Amazon Translate for the translated text response.
     #   @return [Array<Types::AppliedTerminology>]
     #
+    # @!attribute [rw] applied_settings
+    #   Settings that configure the translation output.
+    #   @return [Types::TranslationSettings]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslateTextResponse AWS API Documentation
     #
     class TranslateTextResponse < Struct.new(
       :translated_text,
       :source_language_code,
       :target_language_code,
-      :applied_terminologies)
+      :applied_terminologies,
+      :applied_settings)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Settings that configure the translation output.
+    #
+    # @note When making an API call, you may pass TranslationSettings
+    #   data as a hash:
+    #
+    #       {
+    #         profanity: "MASK", # accepts MASK
+    #       }
+    #
+    # @!attribute [rw] profanity
+    #   Enable the profanity setting if you want Amazon Translate to mask
+    #   profane words and phrases in your translation output.
+    #
+    #   To mask profane words and phrases, Amazon Translate replaces them
+    #   with the grawlix string “?$#@$“. This 5-character sequence is used
+    #   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
+    #   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
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01/TranslationSettings AWS API Documentation
+    #
+    class TranslationSettings < Struct.new(
+      :profanity)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-translate.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-translate
 version: !ruby/object:Gem::Version
-  version: 1.36.0
+  version: 1.40.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-04 00:00:00.000000000 Z
+date: 2021-11-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core