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

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.

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.

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]

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

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

cpanm Paws::SDK::Config

perl -MCPAN -e shell
install Paws::SDK::Config