@aws-sdk/client-translate 3.229.0 → 3.232.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -9,7 +9,7 @@
9
9
 
10
10
  AWS SDK for JavaScript Translate Client for Node.js, Browser and React Native.
11
11
 
12
- <p>Provides language translation for input text in the source language to the specified target language.</p>
12
+ <p>Provides translation of the input content from the source language to the target language.</p>
13
13
 
14
14
  ## Installing
15
15
 
@@ -6,7 +6,7 @@ exports.ruleSet = {
6
6
  parameters: {
7
7
  Region: {
8
8
  builtIn: "AWS::Region",
9
- required: false,
9
+ required: true,
10
10
  documentation: "The AWS region used to dispatch the request.",
11
11
  type: "String",
12
12
  },
@@ -56,15 +56,6 @@ exports.ruleSet = {
56
56
  },
57
57
  ],
58
58
  },
59
- {
60
- fn: "parseURL",
61
- argv: [
62
- {
63
- ref: "Endpoint",
64
- },
65
- ],
66
- assign: "url",
67
- },
68
59
  ],
69
60
  type: "tree",
70
61
  rules: [
@@ -3,7 +3,7 @@ export const ruleSet = {
3
3
  parameters: {
4
4
  Region: {
5
5
  builtIn: "AWS::Region",
6
- required: false,
6
+ required: true,
7
7
  documentation: "The AWS region used to dispatch the request.",
8
8
  type: "String",
9
9
  },
@@ -53,15 +53,6 @@ export const ruleSet = {
53
53
  },
54
54
  ],
55
55
  },
56
- {
57
- fn: "parseURL",
58
- argv: [
59
- {
60
- ref: "Endpoint",
61
- },
62
- ],
63
- assign: "url",
64
- },
65
56
  ],
66
57
  type: "tree",
67
58
  rules: [
@@ -19,7 +19,7 @@ import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./command
19
19
  import { UpdateParallelDataCommandInput, UpdateParallelDataCommandOutput } from "./commands/UpdateParallelDataCommand";
20
20
  import { TranslateClient } from "./TranslateClient";
21
21
  /**
22
- * <p>Provides language translation for input text in the source language to the specified target language.</p>
22
+ * <p>Provides translation of the input content from the source language to the target language.</p>
23
23
  */
24
24
  export declare class Translate extends TranslateClient {
25
25
  /**
@@ -110,16 +110,13 @@ export declare class Translate extends TranslateClient {
110
110
  /**
111
111
  * <p>Starts an asynchronous batch translation job. Use batch translation jobs to
112
112
  * translate large volumes of text across multiple documents at once.
113
- * For batch translation, the input documents must share the same source language. You can specify one
113
+ * For batch translation, you can input documents with different source languages (specify <code>auto</code>
114
+ * as the source language). You can specify one
114
115
  * or more target languages. Batch translation translates each input document into each of the target languages.
115
116
  * For more information, see
116
- * <a href="https://docs.aws.amazon.com/translate/latest/dg/async.html">Asynchronous batch processing</a>
117
- * </p>
117
+ * <a href="https://docs.aws.amazon.com/translate/latest/dg/async.html">Asynchronous batch processing</a>.</p>
118
118
  *
119
119
  * <p>Batch translation jobs can be described with the <a>DescribeTextTranslationJob</a> operation, listed with the <a>ListTextTranslationJobs</a> operation, and stopped with the <a>StopTextTranslationJob</a> operation.</p>
120
- * <note>
121
- * <p>Amazon Translate does not support batch translation of multiple source languages at once.</p>
122
- * </note>
123
120
  */
124
121
  startTextTranslationJob(args: StartTextTranslationJobCommandInput, options?: __HttpHandlerOptions): Promise<StartTextTranslationJobCommandOutput>;
125
122
  startTextTranslationJob(args: StartTextTranslationJobCommandInput, cb: (err: any, data?: StartTextTranslationJobCommandOutput) => void): void;
@@ -141,7 +141,7 @@ declare type TranslateClientResolvedConfigType = __SmithyResolvedConfiguration<_
141
141
  export interface TranslateClientResolvedConfig extends TranslateClientResolvedConfigType {
142
142
  }
143
143
  /**
144
- * <p>Provides language translation for input text in the source language to the specified target language.</p>
144
+ * <p>Provides translation of the input content from the source language to the target language.</p>
145
145
  */
146
146
  export declare class TranslateClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, TranslateClientResolvedConfig> {
147
147
  /**
@@ -10,16 +10,13 @@ export interface StartTextTranslationJobCommandOutput extends StartTextTranslati
10
10
  /**
11
11
  * <p>Starts an asynchronous batch translation job. Use batch translation jobs to
12
12
  * translate large volumes of text across multiple documents at once.
13
- * For batch translation, the input documents must share the same source language. You can specify one
13
+ * For batch translation, you can input documents with different source languages (specify <code>auto</code>
14
+ * as the source language). You can specify one
14
15
  * or more target languages. Batch translation translates each input document into each of the target languages.
15
16
  * For more information, see
16
- * <a href="https://docs.aws.amazon.com/translate/latest/dg/async.html">Asynchronous batch processing</a>
17
- * </p>
17
+ * <a href="https://docs.aws.amazon.com/translate/latest/dg/async.html">Asynchronous batch processing</a>.</p>
18
18
  *
19
19
  * <p>Batch translation jobs can be described with the <a>DescribeTextTranslationJob</a> operation, listed with the <a>ListTextTranslationJobs</a> operation, and stopped with the <a>StopTextTranslationJob</a> operation.</p>
20
- * <note>
21
- * <p>Amazon Translate does not support batch translation of multiple source languages at once.</p>
22
- * </note>
23
20
  * @example
24
21
  * Use a bare-bones client and the command you need to make an API call.
25
22
  * ```javascript
@@ -12,7 +12,7 @@ export declare const resolveClientEndpointParameters: <T>(options: T & ClientInp
12
12
  defaultSigningName: string;
13
13
  };
14
14
  export interface EndpointParameters extends __EndpointParameters {
15
- Region?: string;
15
+ Region: string;
16
16
  UseDualStack?: boolean;
17
17
  UseFIPS?: boolean;
18
18
  Endpoint?: string;
@@ -280,14 +280,8 @@ export interface DescribeTextTranslationJobRequest {
280
280
  export interface InputDataConfig {
281
281
  /**
282
282
  * <p>The URI of the AWS S3 folder that contains the input files. Amazon Translate translates all the
283
- * files in the folder. The folder must be in the same Region as the API endpoint you are
283
+ * files in the folder and all its sub-folders. The folder must be in the same Region as the API endpoint you are
284
284
  * calling.</p>
285
- * <note>
286
- * <p>The URI can also point to a single input document, or it can provide the prefix for a collection of
287
- * input documents. For example. if you use the URI <code>S3://bucketName/prefix</code> and the
288
- * prefix is a single file, Amazon Translate uses that files as input. If more than one file begins with the
289
- * prefix, Amazon Translate uses all of them as input.</p>
290
- * </note>
291
285
  */
292
286
  S3Uri: string | undefined;
293
287
  /**
@@ -398,7 +392,7 @@ export interface TranslationSettings {
398
392
  * ignore the formality setting.</p>
399
393
  * <p> If you specify multiple target languages for the job, translate ignores
400
394
  * the formality setting for any unsupported target language.</p>
401
- * <p>For a list of target languages that support formality, see <a href="https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-formality.html">Setting Formality</a>
395
+ * <p>For a list of target languages that support formality, see <a href="https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-formality.html#customizing-translations-formality-languages">Supported languages</a>
402
396
  * in the Amazon Translate Developer Guide.</p>
403
397
  */
404
398
  Formality?: Formality | string;
@@ -409,8 +403,7 @@ export interface TranslationSettings {
409
403
  * “?$#@$“. This 5-character sequence is used for each profane word or phrase, regardless of the
410
404
  * length or number of words.</p>
411
405
  * <p>Amazon Translate doesn't detect profanity in all of its supported languages. For languages
412
- * that support profanity detection, see <a href="https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-profanity.html">Masking
413
- * profanity</a> in the Amazon Translate Developer Guide.</p>
406
+ * that don't support profanity detection, see <a href="https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-profanity.html#customizing-translations-profanity-languages">Unsupported languages</a> in the Amazon Translate Developer Guide.</p>
414
407
  * <p>If you specify multiple target languages for the job, all the
415
408
  * target languages must support profanity masking. If any of the
416
409
  * target languages don't support profanity masking, the
@@ -1100,16 +1093,17 @@ export interface StartTextTranslationJobRequest {
1100
1093
  */
1101
1094
  DataAccessRoleArn: string | undefined;
1102
1095
  /**
1103
- * <p>The language code of the input language. For a list of language codes, see
1096
+ * <p>The language code of the input language. Specify the language if all input documents share the same language.
1097
+ * If you don't know the language of the source files, or your input documents contains different source
1098
+ * languages, select <code>auto</code>. Amazon Translate auto detects the source language for each input document.
1099
+ * For a list of supported language codes, see
1104
1100
  * <a href="https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html">Supported languages</a>.</p>
1105
- * <p>Amazon Translate does not automatically detect a source language during batch translation jobs.</p>
1106
1101
  */
1107
1102
  SourceLanguageCode: string | undefined;
1108
1103
  /**
1109
1104
  * <p>The target languages of the translation job. Enter up to 10 language codes.
1110
1105
  * Each input file is translated into each target language.</p>
1111
- * <p>Each language code is two or five characters long. For a list of language codes, see
1112
- * <a href="https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html">Supported languages</a>.</p>
1106
+ * <p>Each language code is 2 or 5 characters long. For a list of language codes, see <a href="https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html">Supported languages</a>.</p>
1113
1107
  */
1114
1108
  TargetLanguageCodes: string[] | undefined;
1115
1109
  /**
@@ -1297,8 +1291,8 @@ export declare class TextSizeLimitExceededException extends __BaseException {
1297
1291
  }
1298
1292
  export interface TranslateTextRequest {
1299
1293
  /**
1300
- * <p>The text to translate. The text string can be a maximum of 5,000 bytes long. Depending on
1301
- * your character set, this may be fewer than 5,000 characters.</p>
1294
+ * <p>The text to translate. The text string can be a maximum of 10,000 bytes long. Depending on
1295
+ * your character set, this may be fewer than 10,000 characters.</p>
1302
1296
  */
1303
1297
  Text: string | undefined;
1304
1298
  /**
@@ -27,7 +27,7 @@ export declare const resolveClientEndpointParameters: <T>(
27
27
  defaultSigningName: string;
28
28
  };
29
29
  export interface EndpointParameters extends __EndpointParameters {
30
- Region?: string;
30
+ Region: string;
31
31
  UseDualStack?: boolean;
32
32
  UseFIPS?: boolean;
33
33
  Endpoint?: string;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-translate",
3
3
  "description": "AWS SDK for JavaScript Translate Client for Node.js, Browser and React Native",
4
- "version": "3.229.0",
4
+ "version": "3.232.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -19,9 +19,9 @@
19
19
  "dependencies": {
20
20
  "@aws-crypto/sha256-browser": "2.0.0",
21
21
  "@aws-crypto/sha256-js": "2.0.0",
22
- "@aws-sdk/client-sts": "3.229.0",
23
- "@aws-sdk/config-resolver": "3.226.0",
24
- "@aws-sdk/credential-provider-node": "3.229.0",
22
+ "@aws-sdk/client-sts": "3.231.0",
23
+ "@aws-sdk/config-resolver": "3.231.0",
24
+ "@aws-sdk/credential-provider-node": "3.231.0",
25
25
  "@aws-sdk/fetch-http-handler": "3.226.0",
26
26
  "@aws-sdk/hash-node": "3.226.0",
27
27
  "@aws-sdk/invalid-dependency": "3.226.0",
@@ -45,7 +45,7 @@
45
45
  "@aws-sdk/util-body-length-browser": "3.188.0",
46
46
  "@aws-sdk/util-body-length-node": "3.208.0",
47
47
  "@aws-sdk/util-defaults-mode-browser": "3.226.0",
48
- "@aws-sdk/util-defaults-mode-node": "3.226.0",
48
+ "@aws-sdk/util-defaults-mode-node": "3.231.0",
49
49
  "@aws-sdk/util-endpoints": "3.226.0",
50
50
  "@aws-sdk/util-retry": "3.229.0",
51
51
  "@aws-sdk/util-user-agent-browser": "3.226.0",