Class: Aws::Translate::Client
- Inherits:
-
Seahorse::Client::Base
- Object
- Seahorse::Client::Base
- Aws::Translate::Client
- Includes:
- ClientStubs
- Defined in:
- gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb
Overview
An API client for Translate. To construct a client, you need to configure a :region
and :credentials
.
client = Aws::Translate::Client.new(
region: region_name,
credentials: credentials,
# ...
)
For details on configuring region and credentials see the developer guide.
See #initialize for a full list of supported configuration options.
Instance Attribute Summary
Attributes inherited from Seahorse::Client::Base
API Operations collapse
-
#create_parallel_data(params = {}) ⇒ Types::CreateParallelDataResponse
Creates a parallel data resource in Amazon Translate by importing an input file from Amazon S3.
-
#delete_parallel_data(params = {}) ⇒ Types::DeleteParallelDataResponse
Deletes a parallel data resource in Amazon Translate.
-
#delete_terminology(params = {}) ⇒ Struct
A synchronous action that deletes a custom terminology.
-
#describe_text_translation_job(params = {}) ⇒ Types::DescribeTextTranslationJobResponse
Gets the properties associated with an asynchronous batch translation job including name, ID, status, source and target languages, input/output S3 buckets, and so on.
-
#get_parallel_data(params = {}) ⇒ Types::GetParallelDataResponse
Provides information about a parallel data resource.
-
#get_terminology(params = {}) ⇒ Types::GetTerminologyResponse
Retrieves a custom terminology.
-
#import_terminology(params = {}) ⇒ Types::ImportTerminologyResponse
Creates or updates a custom terminology, depending on whether one already exists for the given terminology name.
-
#list_languages(params = {}) ⇒ Types::ListLanguagesResponse
Provides a list of languages (RFC-5646 codes and names) that Amazon Translate supports.
-
#list_parallel_data(params = {}) ⇒ Types::ListParallelDataResponse
Provides a list of your parallel data resources in Amazon Translate.
-
#list_tags_for_resource(params = {}) ⇒ Types::ListTagsForResourceResponse
Lists all tags associated with a given Amazon Translate resource.
-
#list_terminologies(params = {}) ⇒ Types::ListTerminologiesResponse
Provides a list of custom terminologies associated with your account.
-
#list_text_translation_jobs(params = {}) ⇒ Types::ListTextTranslationJobsResponse
Gets a list of the batch translation jobs that you have submitted.
-
#start_text_translation_job(params = {}) ⇒ Types::StartTextTranslationJobResponse
Starts an asynchronous batch translation job.
-
#stop_text_translation_job(params = {}) ⇒ Types::StopTextTranslationJobResponse
Stops an asynchronous batch translation job that is in progress.
-
#tag_resource(params = {}) ⇒ Struct
Associates a specific tag with a resource.
-
#translate_document(params = {}) ⇒ Types::TranslateDocumentResponse
Translates the input document from the source language to the target language.
-
#translate_text(params = {}) ⇒ Types::TranslateTextResponse
Translates input text from the source language to the target language.
-
#untag_resource(params = {}) ⇒ Struct
Removes a specific tag associated with an Amazon Translate resource.
-
#update_parallel_data(params = {}) ⇒ Types::UpdateParallelDataResponse
Updates a previously created parallel data resource by importing a new input file from Amazon S3.
Instance Method Summary collapse
-
#initialize(options) ⇒ Client
constructor
A new instance of Client.
Methods included from ClientStubs
#api_requests, #stub_data, #stub_responses
Methods inherited from Seahorse::Client::Base
add_plugin, api, clear_plugins, define, new, #operation_names, plugins, remove_plugin, set_api, set_plugins
Methods included from Seahorse::Client::HandlerBuilder
#handle, #handle_request, #handle_response
Constructor Details
#initialize(options) ⇒ Client
Returns a new instance of Client.
397 398 399 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 397 def initialize(*args) super end |
Instance Method Details
#create_parallel_data(params = {}) ⇒ Types::CreateParallelDataResponse
Creates a parallel data resource in Amazon Translate by importing an input file from Amazon S3. Parallel data files contain examples that show how you want segments of text to be translated. By adding parallel data, you can influence the style, tone, and word choice in your translation output.
475 476 477 478 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 475 def create_parallel_data(params = {}, = {}) req = build_request(:create_parallel_data, params) req.send_request() end |
#delete_parallel_data(params = {}) ⇒ Types::DeleteParallelDataResponse
Deletes a parallel data resource in Amazon Translate.
505 506 507 508 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 505 def delete_parallel_data(params = {}, = {}) req = build_request(:delete_parallel_data, params) req.send_request() end |
#delete_terminology(params = {}) ⇒ Struct
A synchronous action that deletes a custom terminology.
527 528 529 530 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 527 def delete_terminology(params = {}, = {}) req = build_request(:delete_terminology, params) req.send_request() end |
#describe_text_translation_job(params = {}) ⇒ Types::DescribeTextTranslationJobResponse
Gets the properties associated with an asynchronous batch translation job including name, ID, status, source and target languages, input/output S3 buckets, and so on.
583 584 585 586 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 583 def describe_text_translation_job(params = {}, = {}) req = build_request(:describe_text_translation_job, params) req.send_request() end |
#get_parallel_data(params = {}) ⇒ Types::GetParallelDataResponse
Provides information about a parallel data resource.
639 640 641 642 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 639 def get_parallel_data(params = {}, = {}) req = build_request(:get_parallel_data, params) req.send_request() end |
#get_terminology(params = {}) ⇒ Types::GetTerminologyResponse
Retrieves a custom terminology.
701 702 703 704 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 701 def get_terminology(params = {}, = {}) req = build_request(:get_terminology, params) req.send_request() end |
#import_terminology(params = {}) ⇒ Types::ImportTerminologyResponse
Creates or updates a custom terminology, depending on whether 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. The only supported merge strategy is OVERWRITE, where the imported terminology overwrites the existing terminology of the same name.
If you import a terminology that overwrites an existing one, the new terminology takes up to 10 minutes to fully propagate. After that, translations have access to the new terminology.
797 798 799 800 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 797 def import_terminology(params = {}, = {}) req = build_request(:import_terminology, params) req.send_request() end |
#list_languages(params = {}) ⇒ Types::ListLanguagesResponse
Provides a list of languages (RFC-5646 codes and names) that Amazon Translate supports.
The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.
844 845 846 847 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 844 def list_languages(params = {}, = {}) req = build_request(:list_languages, params) req.send_request() end |
#list_parallel_data(params = {}) ⇒ Types::ListParallelDataResponse
Provides a list of your parallel data resources in Amazon Translate.
The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.
902 903 904 905 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 902 def list_parallel_data(params = {}, = {}) req = build_request(:list_parallel_data, params) req.send_request() end |
#list_tags_for_resource(params = {}) ⇒ Types::ListTagsForResourceResponse
Lists all tags associated with a given Amazon Translate resource. For more information, see Tagging your resources.
938 939 940 941 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 938 def (params = {}, = {}) req = build_request(:list_tags_for_resource, params) req.send_request() end |
#list_terminologies(params = {}) ⇒ Types::ListTerminologiesResponse
Provides a list of custom terminologies associated with your account.
The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.
991 992 993 994 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 991 def list_terminologies(params = {}, = {}) req = build_request(:list_terminologies, params) req.send_request() end |
#list_text_translation_jobs(params = {}) ⇒ Types::ListTextTranslationJobsResponse
Gets a list of the batch translation jobs that you have submitted.
The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.
1064 1065 1066 1067 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 1064 def list_text_translation_jobs(params = {}, = {}) req = build_request(:list_text_translation_jobs, params) req.send_request() end |
#start_text_translation_job(params = {}) ⇒ Types::StartTextTranslationJobResponse
Starts an asynchronous batch translation job. Use batch translation
jobs to translate large volumes of text across multiple documents at
once. For batch translation, you can input documents with different
source languages (specify auto
as the 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 Asynchronous batch processing.
Batch translation jobs can be described with the DescribeTextTranslationJob operation, listed with the ListTextTranslationJobs operation, and stopped with the StopTextTranslationJob operation.
1238 1239 1240 1241 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 1238 def start_text_translation_job(params = {}, = {}) req = build_request(:start_text_translation_job, params) req.send_request() end |
#stop_text_translation_job(params = {}) ⇒ Types::StopTextTranslationJobResponse
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
.
1278 1279 1280 1281 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 1278 def stop_text_translation_job(params = {}, = {}) req = build_request(:stop_text_translation_job, params) req.send_request() end |
#tag_resource(params = {}) ⇒ Struct
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 Tagging your resources.
1318 1319 1320 1321 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 1318 def tag_resource(params = {}, = {}) req = build_request(:tag_resource, params) req.send_request() end |
#translate_document(params = {}) ⇒ Types::TranslateDocumentResponse
Translates the input document from the source language to the target
language. This synchronous operation supports text, HTML, or Word
documents as the input document. TranslateDocument
supports
translations from English to any supported language, and from any
supported language to English. Therefore, specify either the source
language code or the target language code as “en” (English).
If you set the Formality
parameter, the request will fail if the
target language does not support formality. For a list of target
languages that support formality, see Setting formality.
1440 1441 1442 1443 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 1440 def translate_document(params = {}, = {}) req = build_request(:translate_document, params) req.send_request() end |
#translate_text(params = {}) ⇒ Types::TranslateTextResponse
Translates input text from the source language to the target language. For a list of available languages and language codes, see Supported languages.
1554 1555 1556 1557 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 1554 def translate_text(params = {}, = {}) req = build_request(:translate_text, params) req.send_request() end |
#untag_resource(params = {}) ⇒ Struct
Removes a specific tag associated with an Amazon Translate resource. For more information, see Tagging your resources.
1588 1589 1590 1591 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 1588 def untag_resource(params = {}, = {}) req = build_request(:untag_resource, params) req.send_request() end |
#update_parallel_data(params = {}) ⇒ Types::UpdateParallelDataResponse
Updates a previously created parallel data resource by importing a new input file from Amazon S3.
1643 1644 1645 1646 |
# File 'gems/aws-sdk-translate/lib/aws-sdk-translate/client.rb', line 1643 def update_parallel_data(params = {}, = {}) req = build_request(:update_parallel_data, params) req.send_request() end |