/ - Amazon Translate

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.

curl --location -g --request POST 'http://translate.{region}.amazonaws.com/' \ --header 'X-Amz-Target;' \ --header 'Content-Type: application/json' \ --data-raw '{ "Name": "string", "Description": "string", "ParallelDataConfig": { "S3Uri": "string", "Format": "TSV" }, "EncryptionKey": { "Type": "KMS", "Id": "string" }, "ClientToken": "string" }'

Request

Header Params

X-Amz-Target

string

required

Body Params application/json

Name

string

required

A custom name for the parallel data resource in Amazon Translate. You must assign a name that is unique in the account and region.

>= 1 characters<= 256 characters

Match pattern:

^([A-Za-z0-9-]_?)+$

Description

string

optional

A custom description for the parallel data resource in Amazon Translate.

<= 256 characters

Match pattern:

[\P{M}\p{M}]{0,256}

ParallelDataConfig

object

required

Specifies the format and S3 location of the parallel data input file.

S3Uri

string

required

The URI of the Amazon S3 folder that contains the parallel data input file. The folder must be in the same Region as the API endpoint you are calling.

<= 1024 characters

Match pattern:

s3://[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9](/.*)?

Format

enum<string>

required

The format of the parallel data input file.

Allowed values:

TSVCSVTMX

EncryptionKey

object (EncryptionKey)

optional

The encryption key used to encrypt this object.

Type

enum<string>

required

The type of encryption key used by Amazon Translate to encrypt custom terminologies.

Allowed value:

KMS

string

required

The Amazon Resource Name (ARN) of the encryption key being used to encrypt the custom terminology.

>= 1 characters<= 400 characters

Match pattern:

(arn:aws((-us-gov)|(-iso)|(-iso-b)|(-cn))?:kms:)?([a-z]{2}-[a-z]+(-[a-z]+)?-\d:)?(\d{12}:)?(((key/)?[a-zA-Z0-9-_]+)|(alias/[a-zA-Z0-9:/_-]+))

ClientToken

string

required

A unique identifier for the request. This token is automatically generated when you use Amazon Translate through an AWS SDK.

>= 1 characters<= 64 characters

Match pattern:

^[a-zA-Z0-9-]+$

Examples

Responses

🟢200Success

application/json

Body

Name

string

optional

The custom name that you assigned to the parallel data resource.

>= 1 characters<= 256 characters

Match pattern:

^([A-Za-z0-9-]_?)+$

Status

enum<string>

optional

The status of the parallel data resource. When the resource is ready for you to use, the status is ACTIVE.

Allowed values:

CREATINGUPDATINGACTIVEDELETINGFAILED

🟠480InvalidParameterValueException

🟠481InvalidRequestException

🟠482LimitExceededException

🟠483TooManyRequestsException

🟠484ConflictException

🟠485InternalServerException