@aws-sdk/client-translate 3.185.0 → 3.188.0

package/dist-es/runtimeConfig.browser.js

@@ -1,4 +1,3 @@
-import { __assign, __awaiter, __generator } from "tslib";
 import packageInfo from "../package.json";
 import { Sha256 } from "@aws-crypto/sha256-browser";
 import { DEFAULT_USE_DUALSTACK_ENDPOINT, DEFAULT_USE_FIPS_ENDPOINT } from "@aws-sdk/config-resolver";
@@ -12,15 +11,30 @@ import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8-browser";
 import { getRuntimeConfig as getSharedRuntimeConfig } from "./runtimeConfig.shared";
 import { loadConfigsForDefaultMode } from "@aws-sdk/smithy-client";
 import { resolveDefaultsModeConfig } from "@aws-sdk/util-defaults-mode-browser";
-export var getRuntimeConfig = function (config) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
-    var defaultsMode = resolveDefaultsModeConfig(config);
-    var defaultConfigProvider = function () { return defaultsMode().then(loadConfigsForDefaultMode); };
-    var clientSharedValues = getSharedRuntimeConfig(config);
-    return __assign(__assign(__assign({}, clientSharedValues), config), { runtime: "browser", defaultsMode: defaultsMode, base64Decoder: (_a = config === null || config === void 0 ? void 0 : config.base64Decoder) !== null && _a !== void 0 ? _a : fromBase64, base64Encoder: (_b = config === null || config === void 0 ? void 0 : config.base64Encoder) !== null && _b !== void 0 ? _b : toBase64, bodyLengthChecker: (_c = config === null || config === void 0 ? void 0 : config.bodyLengthChecker) !== null && _c !== void 0 ? _c : calculateBodyLength, credentialDefaultProvider: (_d = config === null || config === void 0 ? void 0 : config.credentialDefaultProvider) !== null && _d !== void 0 ? _d : (function (_) { return function () { return Promise.reject(new Error("Credential is missing")); }; }), defaultUserAgentProvider: (_e = config === null || config === void 0 ? void 0 : config.defaultUserAgentProvider) !== null && _e !== void 0 ? _e : defaultUserAgent({ serviceId: clientSharedValues.serviceId, clientVersion: packageInfo.version }), maxAttempts: (_f = config === null || config === void 0 ? void 0 : config.maxAttempts) !== null && _f !== void 0 ? _f : DEFAULT_MAX_ATTEMPTS, region: (_g = config === null || config === void 0 ? void 0 : config.region) !== null && _g !== void 0 ? _g : invalidProvider("Region is missing"), requestHandler: (_h = config === null || config === void 0 ? void 0 : config.requestHandler) !== null && _h !== void 0 ? _h : new RequestHandler(defaultConfigProvider), retryMode: (_j = config === null || config === void 0 ? void 0 : config.retryMode) !== null && _j !== void 0 ? _j : (function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0: return [4, defaultConfigProvider()];
-                case 1: return [2, (_a.sent()).retryMode || DEFAULT_RETRY_MODE];
-            }
-        }); }); }), sha256: (_k = config === null || config === void 0 ? void 0 : config.sha256) !== null && _k !== void 0 ? _k : Sha256, streamCollector: (_l = config === null || config === void 0 ? void 0 : config.streamCollector) !== null && _l !== void 0 ? _l : streamCollector, useDualstackEndpoint: (_m = config === null || config === void 0 ? void 0 : config.useDualstackEndpoint) !== null && _m !== void 0 ? _m : (function () { return Promise.resolve(DEFAULT_USE_DUALSTACK_ENDPOINT); }), useFipsEndpoint: (_o = config === null || config === void 0 ? void 0 : config.useFipsEndpoint) !== null && _o !== void 0 ? _o : (function () { return Promise.resolve(DEFAULT_USE_FIPS_ENDPOINT); }), utf8Decoder: (_p = config === null || config === void 0 ? void 0 : config.utf8Decoder) !== null && _p !== void 0 ? _p : fromUtf8, utf8Encoder: (_q = config === null || config === void 0 ? void 0 : config.utf8Encoder) !== null && _q !== void 0 ? _q : toUtf8 });
+export const getRuntimeConfig = (config) => {
+    const defaultsMode = resolveDefaultsModeConfig(config);
+    const defaultConfigProvider = () => defaultsMode().then(loadConfigsForDefaultMode);
+    const clientSharedValues = getSharedRuntimeConfig(config);
+    return {
+        ...clientSharedValues,
+        ...config,
+        runtime: "browser",
+        defaultsMode,
+        base64Decoder: config?.base64Decoder ?? fromBase64,
+        base64Encoder: config?.base64Encoder ?? toBase64,
+        bodyLengthChecker: config?.bodyLengthChecker ?? calculateBodyLength,
+        credentialDefaultProvider: config?.credentialDefaultProvider ?? ((_) => () => Promise.reject(new Error("Credential is missing"))),
+        defaultUserAgentProvider: config?.defaultUserAgentProvider ??
+            defaultUserAgent({ serviceId: clientSharedValues.serviceId, clientVersion: packageInfo.version }),
+        maxAttempts: config?.maxAttempts ?? DEFAULT_MAX_ATTEMPTS,
+        region: config?.region ?? invalidProvider("Region is missing"),
+        requestHandler: config?.requestHandler ?? new RequestHandler(defaultConfigProvider),
+        retryMode: config?.retryMode ?? (async () => (await defaultConfigProvider()).retryMode || DEFAULT_RETRY_MODE),
+        sha256: config?.sha256 ?? Sha256,
+        streamCollector: config?.streamCollector ?? streamCollector,
+        useDualstackEndpoint: config?.useDualstackEndpoint ?? (() => Promise.resolve(DEFAULT_USE_DUALSTACK_ENDPOINT)),
+        useFipsEndpoint: config?.useFipsEndpoint ?? (() => Promise.resolve(DEFAULT_USE_FIPS_ENDPOINT)),
+        utf8Decoder: config?.utf8Decoder ?? fromUtf8,
+        utf8Encoder: config?.utf8Encoder ?? toUtf8,
+    };
 };

package/dist-es/runtimeConfig.js

@@ -1,4 +1,3 @@
-import { __assign, __awaiter, __generator } from "tslib";
 import packageInfo from "../package.json";
 import { decorateDefaultCredentialProvider } from "@aws-sdk/client-sts";
 import { NODE_REGION_CONFIG_FILE_OPTIONS, NODE_REGION_CONFIG_OPTIONS, NODE_USE_DUALSTACK_ENDPOINT_CONFIG_OPTIONS, NODE_USE_FIPS_ENDPOINT_CONFIG_OPTIONS, } from "@aws-sdk/config-resolver";
@@ -15,16 +14,35 @@ import { getRuntimeConfig as getSharedRuntimeConfig } from "./runtimeConfig.shar
 import { loadConfigsForDefaultMode } from "@aws-sdk/smithy-client";
 import { resolveDefaultsModeConfig } from "@aws-sdk/util-defaults-mode-node";
 import { emitWarningIfUnsupportedVersion } from "@aws-sdk/smithy-client";
-export var getRuntimeConfig = function (config) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+export const getRuntimeConfig = (config) => {
     emitWarningIfUnsupportedVersion(process.version);
-    var defaultsMode = resolveDefaultsModeConfig(config);
-    var defaultConfigProvider = function () { return defaultsMode().then(loadConfigsForDefaultMode); };
-    var clientSharedValues = getSharedRuntimeConfig(config);
-    return __assign(__assign(__assign({}, clientSharedValues), config), { runtime: "node", defaultsMode: defaultsMode, base64Decoder: (_a = config === null || config === void 0 ? void 0 : config.base64Decoder) !== null && _a !== void 0 ? _a : fromBase64, base64Encoder: (_b = config === null || config === void 0 ? void 0 : config.base64Encoder) !== null && _b !== void 0 ? _b : toBase64, bodyLengthChecker: (_c = config === null || config === void 0 ? void 0 : config.bodyLengthChecker) !== null && _c !== void 0 ? _c : calculateBodyLength, credentialDefaultProvider: (_d = config === null || config === void 0 ? void 0 : config.credentialDefaultProvider) !== null && _d !== void 0 ? _d : decorateDefaultCredentialProvider(credentialDefaultProvider), defaultUserAgentProvider: (_e = config === null || config === void 0 ? void 0 : config.defaultUserAgentProvider) !== null && _e !== void 0 ? _e : defaultUserAgent({ serviceId: clientSharedValues.serviceId, clientVersion: packageInfo.version }), maxAttempts: (_f = config === null || config === void 0 ? void 0 : config.maxAttempts) !== null && _f !== void 0 ? _f : loadNodeConfig(NODE_MAX_ATTEMPT_CONFIG_OPTIONS), region: (_g = config === null || config === void 0 ? void 0 : config.region) !== null && _g !== void 0 ? _g : loadNodeConfig(NODE_REGION_CONFIG_OPTIONS, NODE_REGION_CONFIG_FILE_OPTIONS), requestHandler: (_h = config === null || config === void 0 ? void 0 : config.requestHandler) !== null && _h !== void 0 ? _h : new RequestHandler(defaultConfigProvider), retryMode: (_j = config === null || config === void 0 ? void 0 : config.retryMode) !== null && _j !== void 0 ? _j : loadNodeConfig(__assign(__assign({}, NODE_RETRY_MODE_CONFIG_OPTIONS), { default: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4, defaultConfigProvider()];
-                    case 1: return [2, (_a.sent()).retryMode || DEFAULT_RETRY_MODE];
-                }
-            }); }); } })), sha256: (_k = config === null || config === void 0 ? void 0 : config.sha256) !== null && _k !== void 0 ? _k : Hash.bind(null, "sha256"), streamCollector: (_l = config === null || config === void 0 ? void 0 : config.streamCollector) !== null && _l !== void 0 ? _l : streamCollector, useDualstackEndpoint: (_m = config === null || config === void 0 ? void 0 : config.useDualstackEndpoint) !== null && _m !== void 0 ? _m : loadNodeConfig(NODE_USE_DUALSTACK_ENDPOINT_CONFIG_OPTIONS), useFipsEndpoint: (_o = config === null || config === void 0 ? void 0 : config.useFipsEndpoint) !== null && _o !== void 0 ? _o : loadNodeConfig(NODE_USE_FIPS_ENDPOINT_CONFIG_OPTIONS), utf8Decoder: (_p = config === null || config === void 0 ? void 0 : config.utf8Decoder) !== null && _p !== void 0 ? _p : fromUtf8, utf8Encoder: (_q = config === null || config === void 0 ? void 0 : config.utf8Encoder) !== null && _q !== void 0 ? _q : toUtf8 });
+    const defaultsMode = resolveDefaultsModeConfig(config);
+    const defaultConfigProvider = () => defaultsMode().then(loadConfigsForDefaultMode);
+    const clientSharedValues = getSharedRuntimeConfig(config);
+    return {
+        ...clientSharedValues,
+        ...config,
+        runtime: "node",
+        defaultsMode,
+        base64Decoder: config?.base64Decoder ?? fromBase64,
+        base64Encoder: config?.base64Encoder ?? toBase64,
+        bodyLengthChecker: config?.bodyLengthChecker ?? calculateBodyLength,
+        credentialDefaultProvider: config?.credentialDefaultProvider ?? decorateDefaultCredentialProvider(credentialDefaultProvider),
+        defaultUserAgentProvider: config?.defaultUserAgentProvider ??
+            defaultUserAgent({ serviceId: clientSharedValues.serviceId, clientVersion: packageInfo.version }),
+        maxAttempts: config?.maxAttempts ?? loadNodeConfig(NODE_MAX_ATTEMPT_CONFIG_OPTIONS),
+        region: config?.region ?? loadNodeConfig(NODE_REGION_CONFIG_OPTIONS, NODE_REGION_CONFIG_FILE_OPTIONS),
+        requestHandler: config?.requestHandler ?? new RequestHandler(defaultConfigProvider),
+        retryMode: config?.retryMode ??
+            loadNodeConfig({
+                ...NODE_RETRY_MODE_CONFIG_OPTIONS,
+                default: async () => (await defaultConfigProvider()).retryMode || DEFAULT_RETRY_MODE,
+            }),
+        sha256: config?.sha256 ?? Hash.bind(null, "sha256"),
+        streamCollector: config?.streamCollector ?? streamCollector,
+        useDualstackEndpoint: config?.useDualstackEndpoint ?? loadNodeConfig(NODE_USE_DUALSTACK_ENDPOINT_CONFIG_OPTIONS),
+        useFipsEndpoint: config?.useFipsEndpoint ?? loadNodeConfig(NODE_USE_FIPS_ENDPOINT_CONFIG_OPTIONS),
+        utf8Decoder: config?.utf8Decoder ?? fromUtf8,
+        utf8Encoder: config?.utf8Encoder ?? toUtf8,
+    };
 };

package/dist-es/runtimeConfig.native.js

@@ -1,8 +1,11 @@
-import { __assign } from "tslib";
 import { Sha256 } from "@aws-crypto/sha256-js";
 import { getRuntimeConfig as getBrowserRuntimeConfig } from "./runtimeConfig.browser";
-export var getRuntimeConfig = function (config) {
-    var _a;
-    var browserDefaults = getBrowserRuntimeConfig(config);
-    return __assign(__assign(__assign({}, browserDefaults), config), { runtime: "react-native", sha256: (_a = config === null || config === void 0 ? void 0 : config.sha256) !== null && _a !== void 0 ? _a : Sha256 });
+export const getRuntimeConfig = (config) => {
+    const browserDefaults = getBrowserRuntimeConfig(config);
+    return {
+        ...browserDefaults,
+        ...config,
+        runtime: "react-native",
+        sha256: config?.sha256 ?? Sha256,
+    };
 };

package/dist-es/runtimeConfig.shared.js

@@ -1,13 +1,10 @@
 import { parseUrl } from "@aws-sdk/url-parser";
 import { defaultRegionInfoProvider } from "./endpoints";
-export var getRuntimeConfig = function (config) {
-    var _a, _b, _c, _d, _e;
-    return ({
-        apiVersion: "2017-07-01",
-        disableHostPrefix: (_a = config === null || config === void 0 ? void 0 : config.disableHostPrefix) !== null && _a !== void 0 ? _a : false,
-        logger: (_b = config === null || config === void 0 ? void 0 : config.logger) !== null && _b !== void 0 ? _b : {},
-        regionInfoProvider: (_c = config === null || config === void 0 ? void 0 : config.regionInfoProvider) !== null && _c !== void 0 ? _c : defaultRegionInfoProvider,
-        serviceId: (_d = config === null || config === void 0 ? void 0 : config.serviceId) !== null && _d !== void 0 ? _d : "Translate",
-        urlParser: (_e = config === null || config === void 0 ? void 0 : config.urlParser) !== null && _e !== void 0 ? _e : parseUrl,
-    });
-};
+export const getRuntimeConfig = (config) => ({
+    apiVersion: "2017-07-01",
+    disableHostPrefix: config?.disableHostPrefix ?? false,
+    logger: config?.logger ?? {},
+    regionInfoProvider: config?.regionInfoProvider ?? defaultRegionInfoProvider,
+    serviceId: config?.serviceId ?? "Translate",
+    urlParser: config?.urlParser ?? parseUrl,
+});

package/dist-types/Translate.d.ts

@@ -19,8 +19,7 @@ import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./command
 import { UpdateParallelDataCommandInput, UpdateParallelDataCommandOutput } from "./commands/UpdateParallelDataCommand";
 import { TranslateClient } from "./TranslateClient";
 /**
- * <p>Provides translation between one source language and another of the same set of
- *       languages.</p>
+ * <p>Provides language translation for input text in the source language to the specified target language.</p>
  */
 export declare class Translate extends TranslateClient {
     /**
@@ -88,6 +87,11 @@ export declare class Translate extends TranslateClient {
     listParallelData(args: ListParallelDataCommandInput, options?: __HttpHandlerOptions): Promise<ListParallelDataCommandOutput>;
     listParallelData(args: ListParallelDataCommandInput, cb: (err: any, data?: ListParallelDataCommandOutput) => void): void;
     listParallelData(args: ListParallelDataCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListParallelDataCommandOutput) => void): void;
+    /**
+     * <p>Lists all tags associated with a given Amazon Translate resource.
+     *       For more information, see <a href="https://docs.aws.amazon.com/translate/latest/dg/tagging.html">
+     *         Tagging your resources</a>.</p>
+     */
     listTagsForResource(args: ListTagsForResourceCommandInput, options?: __HttpHandlerOptions): Promise<ListTagsForResourceCommandOutput>;
     listTagsForResource(args: ListTagsForResourceCommandInput, cb: (err: any, data?: ListTagsForResourceCommandOutput) => void): void;
     listTagsForResource(args: ListTagsForResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTagsForResourceCommandOutput) => void): void;
@@ -104,9 +108,13 @@ export declare class Translate extends TranslateClient {
     listTextTranslationJobs(args: ListTextTranslationJobsCommandInput, cb: (err: any, data?: ListTextTranslationJobsCommandOutput) => void): void;
     listTextTranslationJobs(args: ListTextTranslationJobsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListTextTranslationJobsCommandOutput) => void): void;
     /**
-     * <p>Starts an asynchronous batch translation job. Batch translation jobs can be used to
-     *       translate large volumes of text across multiple documents at once. For more information, see
-     *         <a>async</a>.</p>
+     * <p>Starts an asynchronous batch translation job. Use batch translation jobs to
+     *       translate large volumes of text across multiple documents at once.
+     *       For batch translation, the input documents must share the same source language. You can specify one
+     *       or more target languages. Batch translation translates each input document into each of the target languages.
+     *       For more information, see
+     *       <a href="https://docs.aws.amazon.com/translate/latest/dg/async.html">Asynchronous batch processing</a>
+     *          </p>
      *
      *          <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>
      *          <note>
@@ -128,16 +136,27 @@ export declare class Translate extends TranslateClient {
     stopTextTranslationJob(args: StopTextTranslationJobCommandInput, options?: __HttpHandlerOptions): Promise<StopTextTranslationJobCommandOutput>;
     stopTextTranslationJob(args: StopTextTranslationJobCommandInput, cb: (err: any, data?: StopTextTranslationJobCommandOutput) => void): void;
     stopTextTranslationJob(args: StopTextTranslationJobCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: StopTextTranslationJobCommandOutput) => void): void;
+    /**
+     * <p>Associates a specific tag with a resource. A tag is a key-value pair
+     *       that adds as a metadata to a resource.
+     *       For more information, see <a href="https://docs.aws.amazon.com/translate/latest/dg/tagging.html">
+     *         Tagging your resources</a>.</p>
+     */
     tagResource(args: TagResourceCommandInput, options?: __HttpHandlerOptions): Promise<TagResourceCommandOutput>;
     tagResource(args: TagResourceCommandInput, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
     tagResource(args: TagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
     /**
      * <p>Translates input text from the source language to the target language. For a list of
-     *       available languages and language codes, see <a>what-is-languages</a>.</p>
+     *       available languages and language codes, see <a href="https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html">Supported languages</a>.</p>
      */
     translateText(args: TranslateTextCommandInput, options?: __HttpHandlerOptions): Promise<TranslateTextCommandOutput>;
     translateText(args: TranslateTextCommandInput, cb: (err: any, data?: TranslateTextCommandOutput) => void): void;
     translateText(args: TranslateTextCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TranslateTextCommandOutput) => void): void;
+    /**
+     * <p>Removes a specific tag associated with an Amazon Translate resource.
+     *       For more information, see <a href="https://docs.aws.amazon.com/translate/latest/dg/tagging.html">
+     *         Tagging your resources</a>.</p>
+     */
     untagResource(args: UntagResourceCommandInput, options?: __HttpHandlerOptions): Promise<UntagResourceCommandOutput>;
     untagResource(args: UntagResourceCommandInput, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
     untagResource(args: UntagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;

package/dist-types/TranslateClient.d.ts

@@ -144,8 +144,7 @@ declare type TranslateClientResolvedConfigType = __SmithyResolvedConfiguration<_
 export interface TranslateClientResolvedConfig extends TranslateClientResolvedConfigType {
 }
 /**
- * <p>Provides translation between one source language and another of the same set of
- *       languages.</p>
+ * <p>Provides language translation for input text in the source language to the specified target language.</p>
  */
 export declare class TranslateClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, TranslateClientResolvedConfig> {
     /**

package/dist-types/commands/ListTagsForResourceCommand.d.ts

@@ -6,6 +6,25 @@ export interface ListTagsForResourceCommandInput extends ListTagsForResourceRequ
 }
 export interface ListTagsForResourceCommandOutput extends ListTagsForResourceResponse, __MetadataBearer {
 }
+/**
+ * <p>Lists all tags associated with a given Amazon Translate resource.
+ *       For more information, see <a href="https://docs.aws.amazon.com/translate/latest/dg/tagging.html">
+ *         Tagging your resources</a>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { TranslateClient, ListTagsForResourceCommand } from "@aws-sdk/client-translate"; // ES Modules import
+ * // const { TranslateClient, ListTagsForResourceCommand } = require("@aws-sdk/client-translate"); // CommonJS import
+ * const client = new TranslateClient(config);
+ * const command = new ListTagsForResourceCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link ListTagsForResourceCommandInput} for command's `input` shape.
+ * @see {@link ListTagsForResourceCommandOutput} for command's `response` shape.
+ * @see {@link TranslateClientResolvedConfig | config} for TranslateClient's `config` shape.
+ *
+ */
 export declare class ListTagsForResourceCommand extends $Command<ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput, TranslateClientResolvedConfig> {
     readonly input: ListTagsForResourceCommandInput;
     constructor(input: ListTagsForResourceCommandInput);

package/dist-types/commands/StartTextTranslationJobCommand.d.ts

@@ -7,9 +7,13 @@ export interface StartTextTranslationJobCommandInput extends StartTextTranslatio
 export interface StartTextTranslationJobCommandOutput extends StartTextTranslationJobResponse, __MetadataBearer {
 }
 /**
- * <p>Starts an asynchronous batch translation job. Batch translation jobs can be used to
- *       translate large volumes of text across multiple documents at once. For more information, see
- *         <a>async</a>.</p>
+ * <p>Starts an asynchronous batch translation job. Use batch translation jobs to
+ *       translate large volumes of text across multiple documents at once.
+ *       For batch translation, the input documents must share the same source language. You can specify one
+ *       or more target languages. Batch translation translates each input document into each of the target languages.
+ *       For more information, see
+ *       <a href="https://docs.aws.amazon.com/translate/latest/dg/async.html">Asynchronous batch processing</a>
+ *          </p>
  *
  *          <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>
  *          <note>

package/dist-types/commands/TagResourceCommand.d.ts

@@ -6,6 +6,26 @@ export interface TagResourceCommandInput extends TagResourceRequest {
 }
 export interface TagResourceCommandOutput extends TagResourceResponse, __MetadataBearer {
 }
+/**
+ * <p>Associates a specific tag with a resource. A tag is a key-value pair
+ *       that adds as a metadata to a resource.
+ *       For more information, see <a href="https://docs.aws.amazon.com/translate/latest/dg/tagging.html">
+ *         Tagging your resources</a>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { TranslateClient, TagResourceCommand } from "@aws-sdk/client-translate"; // ES Modules import
+ * // const { TranslateClient, TagResourceCommand } = require("@aws-sdk/client-translate"); // CommonJS import
+ * const client = new TranslateClient(config);
+ * const command = new TagResourceCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link TagResourceCommandInput} for command's `input` shape.
+ * @see {@link TagResourceCommandOutput} for command's `response` shape.
+ * @see {@link TranslateClientResolvedConfig | config} for TranslateClient's `config` shape.
+ *
+ */
 export declare class TagResourceCommand extends $Command<TagResourceCommandInput, TagResourceCommandOutput, TranslateClientResolvedConfig> {
     readonly input: TagResourceCommandInput;
     constructor(input: TagResourceCommandInput);

package/dist-types/commands/TranslateTextCommand.d.ts

@@ -8,7 +8,7 @@ export interface TranslateTextCommandOutput extends TranslateTextResponse, __Met
 }
 /**
  * <p>Translates input text from the source language to the target language. For a list of
- *       available languages and language codes, see <a>what-is-languages</a>.</p>
+ *       available languages and language codes, see <a href="https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html">Supported languages</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/UntagResourceCommand.d.ts

@@ -6,6 +6,25 @@ export interface UntagResourceCommandInput extends UntagResourceRequest {
 }
 export interface UntagResourceCommandOutput extends UntagResourceResponse, __MetadataBearer {
 }
+/**
+ * <p>Removes a specific tag associated with an Amazon Translate resource.
+ *       For more information, see <a href="https://docs.aws.amazon.com/translate/latest/dg/tagging.html">
+ *         Tagging your resources</a>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { TranslateClient, UntagResourceCommand } from "@aws-sdk/client-translate"; // ES Modules import
+ * // const { TranslateClient, UntagResourceCommand } = require("@aws-sdk/client-translate"); // CommonJS import
+ * const client = new TranslateClient(config);
+ * const command = new UntagResourceCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link UntagResourceCommandInput} for command's `input` shape.
+ * @see {@link UntagResourceCommandOutput} for command's `response` shape.
+ * @see {@link TranslateClientResolvedConfig | config} for TranslateClient's `config` shape.
+ *
+ */
 export declare class UntagResourceCommand extends $Command<UntagResourceCommandInput, UntagResourceCommandOutput, TranslateClientResolvedConfig> {
     readonly input: UntagResourceCommandInput;
     constructor(input: UntagResourceCommandInput);

package/dist-types/models/models_0.d.ts

@@ -92,8 +92,18 @@ export interface ParallelDataConfig {
      */
     Format: ParallelDataFormat | string | undefined;
 }
+/**
+ * <p>A key-value pair that adds as a metadata to a resource used by Amazon Translate. </p>
+ */
 export interface Tag {
+    /**
+     * <p>The initial part of a key-value pair that forms a tag associated with a given resource.
+     *     </p>
+     */
     Key: string | undefined;
+    /**
+     * <p> The second part of a key-value pair that forms a tag associated with a given resource.</p>
+     */
     Value: string | undefined;
 }
 export interface CreateParallelDataRequest {
@@ -119,6 +129,12 @@ export interface CreateParallelDataRequest {
      *       Amazon Translate through an AWS SDK.</p>
      */
     ClientToken?: string;
+    /**
+     * <p>Tags to be associated with this resource. A tag is a key-value pair that
+     *       adds metadata to a resource. Each tag key for the resource must be unique.
+     *       For more information, see <a href="https://docs.aws.amazon.com/translate/latest/dg/tagging.html">
+     *         Tagging your resources</a>.</p>
+     */
     Tags?: Tag[];
 }
 export declare enum ParallelDataStatus {
@@ -203,6 +219,9 @@ export declare class TooManyRequestsException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<TooManyRequestsException, __BaseException>);
 }
+/**
+ * <p>You have added too many tags to this resource. The maximum is 50 tags.</p>
+ */
 export declare class TooManyTagsException extends __BaseException {
     readonly name: "TooManyTagsException";
     readonly $fault: "client";
@@ -366,20 +385,21 @@ export declare enum Profanity {
     MASK = "MASK"
 }
 /**
- * <p>Settings that configure the translation output.</p>
+ * <p>Optional settings that configure the translation output. Use these settings for
+ *       real time translations and asynchronous translation jobs.</p>
  */
 export interface TranslationSettings {
     /**
-     * <p>You can optionally specify the desired level of
-     *        formality for real-time translations to supported target languages. The formality
+     * <p>You can optionally specify the desired level of formality for translations
+     *         to supported target languages. The formality
      *       setting controls the level of formal language usage (also known as <a href="https://en.wikipedia.org/wiki/Register_(sociolinguistics)">register</a>) 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.</p>
-     *          <p>Note that asynchronous translation jobs don't support formality. If you provide a value
-     *       for formality, the <code>StartTextTranslationJob</code> API throws an exception (InvalidRequestException).</p>
-     *          <p>For target languages that support formality, see <a href="https://docs.aws.amazon.com/translate/latest/dg/what-is.html">Supported
-     *         Languages and Language Codes in the Amazon Translate Developer Guide</a>.</p>
+     *          <p> If you specify multiple target languages for the job, translate ignores
+     *       the formality setting for any unsupported target language.</p>
+     *          <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>
+     *       in the Amazon Translate Developer Guide.</p>
      */
     Formality?: Formality | string;
     /**
@@ -389,8 +409,13 @@ export interface TranslationSettings {
      *       “?$#@$“. This 5-character sequence is used for each profane word or phrase, regardless of the
      *       length or number of words.</p>
      *          <p>Amazon Translate doesn't detect profanity in all of its supported languages. For languages
-     *       that support profanity detection, see <a href="https://docs.aws.amazon.com/translate/latest/dg/what-is.html">Supported
-     *         Languages and Language Codes in the Amazon Translate Developer Guide</a>.</p>
+     *       that support profanity detection, see <a href="https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-profanity.html">Masking
+     *         profanity</a> in the Amazon Translate Developer Guide.</p>
+     *          <p>If you specify multiple target languages for the job, all the
+     *       target languages must support profanity masking. If any of the
+     *       target languages don't support profanity masking, the
+     *       translation job won't mask profanity for any target
+     *       language.</p>
      */
     Profanity?: Profanity | string;
 }
@@ -778,7 +803,8 @@ export declare enum MergeStrategy {
     OVERWRITE = "OVERWRITE"
 }
 /**
- * <p>The data associated with the custom terminology. For information about the custom terminology file, see <a href="https://docs.aws.amazon.com/translate/latest/dg/creating-custom-terminology.html">
+ * <p>The data associated with the custom terminology. For information about the custom terminology file, see
+ *       <a href="https://docs.aws.amazon.com/translate/latest/dg/creating-custom-terminology.html">
  *       Creating a Custom Terminology</a>.</p>
  */
 export interface TerminologyData {
@@ -838,6 +864,12 @@ export interface ImportTerminologyRequest {
      * <p>The encryption key for the custom terminology being imported.</p>
      */
     EncryptionKey?: EncryptionKey;
+    /**
+     * <p>Tags to be associated with this resource. A tag is a key-value pair that
+     *       adds metadata to a resource. Each tag key for the resource must be unique.
+     *       For more information, see <a href="https://docs.aws.amazon.com/translate/latest/dg/tagging.html">
+     *         Tagging your resources</a>.</p>
+     */
     Tags?: Tag[];
 }
 export interface ImportTerminologyResponse {
@@ -946,9 +978,19 @@ export interface ListParallelDataResponse {
     NextToken?: string;
 }
 export interface ListTagsForResourceRequest {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the given Amazon Translate resource you are querying.
+     *     </p>
+     */
     ResourceArn: string | undefined;
 }
 export interface ListTagsForResourceResponse {
+    /**
+     * <p>Tags associated with the Amazon Translate resource being queried. A tag is a key-value
+     *       pair that adds as a metadata to a resource used by Amazon Translate. For example, a tag with
+     *       "Sales" as the key might be added to a resource to indicate its use by the sales department.
+     *     </p>
+     */
     Tags?: Tag[];
 }
 export interface ListTerminologiesRequest {
@@ -1053,30 +1095,42 @@ export interface StartTextTranslationJobRequest {
     OutputDataConfig: OutputDataConfig | undefined;
     /**
      * <p>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 information, see <a>identity-and-access-management</a>.</p>
+     *       that grants Amazon Translate read access to your input data. For more information, see
+     *       <a href="https://docs.aws.amazon.com/translate/latest/dg/identity-and-access-management.html">Identity and access management </a>.</p>
      */
     DataAccessRoleArn: string | undefined;
     /**
-     * <p>The language code of the input language. For a list of language codes, see <a>what-is-languages</a>.</p>
-     *          <p>Amazon Translate does not automatically detect a source language during batch translation
-     *       jobs.</p>
+     * <p>The language code of the input language. 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>
+     *          <p>Amazon Translate does not automatically detect a source language during batch translation jobs.</p>
      */
     SourceLanguageCode: string | undefined;
     /**
-     * <p>The language code of the output language.</p>
+     * <p>The target languages of the translation job. Enter up to 10 language codes.
+     *       Each input file is translated into each target language.</p>
+     *          <p>Each language code is two or five 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>
      */
     TargetLanguageCodes: string[] | undefined;
     /**
      * <p>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.</p>
      *          <p>This parameter accepts only one custom terminology resource.</p>
+     *          <p>If you specify multiple target languages for the
+     *       job, translate uses the designated terminology for each
+     *       requested target language that has an entry for the source term
+     *       in the terminology file.</p>
      *          <p>For a list of available custom terminology resources, use the <a>ListTerminologies</a> operation.</p>
-     *          <p>For more information, see <a>how-custom-terminology</a>.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/translate/latest/dg/how-custom-terminology.html">Custom terminology</a>.</p>
      */
     TerminologyNames?: string[];
     /**
      * <p>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
+     *       of examples that show how you want segments of text to be translated.
+     *       If you specify multiple target languages for
+     *       the job, the parallel data file must include translations for
+     *       all the target languages.</p>
+     *          <p>When you add parallel
      *       data to a translation job, you create an <i>Active Custom Translation</i> job. </p>
      *          <p>This parameter accepts only one parallel data resource.</p>
      *          <note>
@@ -1084,7 +1138,8 @@ export interface StartTextTranslationJobRequest {
      *         use parallel data. For more information, see <a href="http://aws.amazon.com/translate/pricing/">Amazon Translate pricing</a>.</p>
      *          </note>
      *          <p>For a list of available parallel data resources, use the <a>ListParallelData</a> operation.</p>
-     *          <p>For more information, see <a>customizing-translations-parallel-data</a>.</p>
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-parallel-data.html">
+     *     Customizing your translations with parallel data</a>.</p>
      */
     ParallelDataNames?: string[];
     /**
@@ -1093,8 +1148,8 @@ export interface StartTextTranslationJobRequest {
      */
     ClientToken?: string;
     /**
-     * <p>Settings to configure your translation output, including the option to mask profane words
-     *       and phrases. <code>StartTextTranslationJob</code> does not support the formality setting.</p>
+     * <p>Settings to configure your translation output, including the option to set the formality
+     *       level of the output text and the option to mask profane words and phrases.</p>
      */
     Settings?: TranslationSettings;
 }
@@ -1145,7 +1200,7 @@ export interface StartTextTranslationJobResponse {
 }
 /**
  * <p>Amazon Translate does not support translation from the language of the source text into the requested
- *       target language. For more information, see <a>how-to-error-msg</a>. </p>
+ *       target language. For more information, see <a href="https://docs.aws.amazon.com/translate/latest/dg/how-to-error-msg.html">Error messages</a>. </p>
  */
 export declare class UnsupportedLanguagePairException extends __BaseException {
     readonly name: "UnsupportedLanguagePairException";
@@ -1182,7 +1237,15 @@ export interface StopTextTranslationJobResponse {
     JobStatus?: JobStatus | string;
 }
 export interface TagResourceRequest {
+    /**
+     * <p>The Amazon Resource Name (ARN) of the given Amazon Translate resource to which you want
+     *       to associate the tags. </p>
+     */
     ResourceArn: string | undefined;
+    /**
+     * <p>Tags being associated with a specific Amazon Translate resource. There can be a maximum
+     *       of 50 tags (both existing and pending) associated with a specific resource.</p>
+     */
     Tags: Tag[] | undefined;
 }
 export interface TagResourceResponse {
@@ -1246,7 +1309,7 @@ export interface TranslateTextRequest {
     TerminologyNames?: string[];
     /**
      * <p>The language code for the language of the source text. The language must be a language
-     *       supported by Amazon Translate. For a list of language codes, see <a>what-is-languages</a>.</p>
+     *       supported by Amazon Translate. 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>
      *          <p>To have Amazon Translate determine the source language of your text, you can specify
      *         <code>auto</code> in the <code>SourceLanguageCode</code> field. If you specify
      *         <code>auto</code>, Amazon Translate will call <a href="https://docs.aws.amazon.com/comprehend/latest/dg/comprehend-general.html">Amazon
@@ -1292,7 +1355,16 @@ export interface TranslateTextResponse {
     AppliedSettings?: TranslationSettings;
 }
 export interface UntagResourceRequest {
+    /**
+     * <p> The Amazon Resource Name (ARN) of the given Amazon Translate resource from which you
+     *       want to remove the tags. </p>
+     */
     ResourceArn: string | undefined;
+    /**
+     * <p>The initial part of a key-value pair that forms a tag being removed from a given resource.
+     *         Keys must be unique and cannot be duplicated for a particular resource.
+     *     </p>
+     */
     TagKeys: string[] | undefined;
 }
 export interface UntagResourceResponse {