NAME

Paws::Translate - Perl Interface to AWS Amazon Translate

SYNOPSIS

use Paws;

my $obj = Paws->service('Translate');
my $res = $obj->Method(
  Arg1 => $val1,
  Arg2 => [ 'V1', 'V2' ],
  # if Arg3 is an object, the HashRef will be used as arguments to the constructor
  # of the arguments type
  Arg3 => { Att1 => 'Val1' },
  # if Arg4 is an array of objects, the HashRefs will be passed as arguments to
  # the constructor of the arguments type
  Arg4 => [ { Att1 => 'Val1'  }, { Att1 => 'Val2' } ],
);

DESCRIPTION

Provides translation between one source language and another of the same set of languages.

For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/translate-2017-07-01

METHODS

CreateParallelData

ClientToken => Str
Name => Str
ParallelDataConfig => Paws::Translate::ParallelDataConfig
[Description => Str]
[EncryptionKey => Paws::Translate::EncryptionKey]

Each argument is described in detail in: Paws::Translate::CreateParallelData

Returns: a Paws::Translate::CreateParallelDataResponse instance

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.

DeleteParallelData

Name => Str

Each argument is described in detail in: Paws::Translate::DeleteParallelData

Returns: a Paws::Translate::DeleteParallelDataResponse instance

Deletes a parallel data resource in Amazon Translate.

DeleteTerminology

Name => Str

Each argument is described in detail in: Paws::Translate::DeleteTerminology

Returns: nothing

A synchronous action that deletes a custom terminology.

DescribeTextTranslationJob

JobId => Str

Each argument is described in detail in: Paws::Translate::DescribeTextTranslationJob

Returns: a Paws::Translate::DescribeTextTranslationJobResponse instance

Gets the properties associated with an asycnhronous batch translation job including name, ID, status, source and target languages, input/output S3 buckets, and so on.

GetParallelData

Name => Str

Each argument is described in detail in: Paws::Translate::GetParallelData

Returns: a Paws::Translate::GetParallelDataResponse instance

Provides information about a parallel data resource.

GetTerminology

Name => Str
TerminologyDataFormat => Str

Each argument is described in detail in: Paws::Translate::GetTerminology

Returns: a Paws::Translate::GetTerminologyResponse instance

Retrieves a custom terminology.

ImportTerminology

MergeStrategy => Str
Name => Str
TerminologyData => Paws::Translate::TerminologyData
[Description => Str]
[EncryptionKey => Paws::Translate::EncryptionKey]

Each argument is described in detail in: Paws::Translate::ImportTerminology

Returns: a Paws::Translate::ImportTerminologyResponse instance

Creates or updates a custom terminology, depending on whether or not one already exists for the given terminology name. Importing a terminology with the same name as an existing one will merge the terminologies based on the chosen merge strategy. Currently, the only supported merge strategy is OVERWRITE, and so the imported terminology will overwrite an existing terminology of the same name.

If you import a terminology that overwrites an existing one, the new terminology take up to 10 minutes to fully propagate and be available for use in a translation due to cache policies with the DataPlane service that performs the translations.

ListParallelData

[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::Translate::ListParallelData

Returns: a Paws::Translate::ListParallelDataResponse instance

Provides a list of your parallel data resources in Amazon Translate.

ListTerminologies

[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::Translate::ListTerminologies

Returns: a Paws::Translate::ListTerminologiesResponse instance

Provides a list of custom terminologies associated with your account.

ListTextTranslationJobs

[Filter => Paws::Translate::TextTranslationJobFilter]
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::Translate::ListTextTranslationJobs

Returns: a Paws::Translate::ListTextTranslationJobsResponse instance

Gets a list of the batch translation jobs that you have submitted.

StartTextTranslationJob

ClientToken => Str
DataAccessRoleArn => Str
InputDataConfig => Paws::Translate::InputDataConfig
OutputDataConfig => Paws::Translate::OutputDataConfig
SourceLanguageCode => Str
TargetLanguageCodes => ArrayRef[Str|Undef]
[JobName => Str]
[ParallelDataNames => ArrayRef[Str|Undef]]
[TerminologyNames => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::Translate::StartTextTranslationJob

Returns: a Paws::Translate::StartTextTranslationJobResponse instance

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 async.

Batch translation jobs can be described with the DescribeTextTranslationJob operation, listed with the ListTextTranslationJobs operation, and stopped with the StopTextTranslationJob operation.

Amazon Translate does not support batch translation of multiple source languages at once.

StopTextTranslationJob

JobId => Str

Each argument is described in detail in: Paws::Translate::StopTextTranslationJob

Returns: a Paws::Translate::StopTextTranslationJobResponse instance

Stops an asynchronous batch translation job that is in progress.

If the job's state is IN_PROGRESS, the job will be marked for termination and put into the STOP_REQUESTED state. If the job completes before it can be stopped, it is put into the COMPLETED state. Otherwise, the job is put into the STOPPED state.

Asynchronous batch translation jobs are started with the StartTextTranslationJob operation. You can use the DescribeTextTranslationJob or ListTextTranslationJobs operations to get a batch translation job's JobId.

TranslateText

SourceLanguageCode => Str
TargetLanguageCode => Str
Text => Str
[TerminologyNames => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::Translate::TranslateText

Returns: a Paws::Translate::TranslateTextResponse instance

Translates input text from the source language to the target language. For a list of available languages and language codes, see what-is-languages.

UpdateParallelData

ClientToken => Str
Name => Str
ParallelDataConfig => Paws::Translate::ParallelDataConfig
[Description => Str]

Each argument is described in detail in: Paws::Translate::UpdateParallelData

Returns: a Paws::Translate::UpdateParallelDataResponse instance

Updates a previously created parallel data resource by importing a new input file from Amazon S3.

PAGINATORS

Paginator methods are helpers that repetively call methods that return partial results

ListAllTerminologies(sub { },[MaxResults => Int, NextToken => Str])

ListAllTerminologies([MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

- TerminologyPropertiesList, passing the object as the first parameter, and the string 'TerminologyPropertiesList' as the second parameter 

If not, it will return a a Paws::Translate::ListTerminologiesResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

SEE ALSO

This service class forms part of Paws

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues