You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.
Class: Aws::TranscribeService::Client OverviewAn API client for Amazon Transcribe Service. To construct a client, you need to configure a :region
and :credentials
.
transcribeservice = Aws::TranscribeService::Client.new(
region: region_name,
credentials: credentials,
)
See #initialize for a full list of supported configuration options.
RegionYou can configure a default region in the following locations:
ENV['AWS_REGION']
Aws.config[:region]
Go here for a list of supported regions.
CredentialsDefault credentials are loaded automatically from the following locations:
ENV['AWS_ACCESS_KEY_ID']
and ENV['AWS_SECRET_ACCESS_KEY']
Aws.config[:credentials]
~/.aws/credentials
(more information)You can also construct a credentials object from one of the following classes:
Alternatively, you configure credentials with :access_key_id
and :secret_access_key
:
creds = YAML.load(File.read('/path/to/secrets'))
Aws::TranscribeService::Client.new(
access_key_id: creds['access_key_id'],
secret_access_key: creds['secret_access_key']
)
Always load your credentials from outside your application. Avoid configuring credentials statically and never commit them to source control.
Attribute Summary collapseConstructs an API client.
Creates a new custom language model.
Creates a new custom vocabulary that you can use to change how Amazon Transcribe Medical transcribes your audio file.
.
Creates a new custom vocabulary that you can use to change the way Amazon Transcribe handles transcription of an audio file.
Creates a new vocabulary filter that you can use to filter words, such as profane words, from the output of a transcription job.
.
Deletes a custom language model using its name.
.
Deletes a transcription job generated by Amazon Transcribe Medical and any related information.
.
Deletes a vocabulary from Amazon Transcribe Medical.
.
Deletes a previously submitted transcription job along with any other generated results such as the transcription, models, and so on.
.
Deletes a vocabulary from Amazon Transcribe.
Removes a vocabulary filter.
.
Gets information about a single custom language model.
Returns information about a transcription job from Amazon Transcribe Medical.
Retrieves information about a medical vocabulary.
.
Returns information about a transcription job.
Gets information about a vocabulary.
Returns information about a vocabulary filter.
.
Provides more information about the custom language models you've created.
Lists medical transcription jobs with a specified status or substring that matches their names.
.
Returns a list of vocabularies that match the specified criteria.
Lists transcription jobs with the specified status.
.
Returns a list of vocabularies that match the specified criteria.
Gets information about vocabulary filters.
.
Starts a batch job to transcribe medical speech to text.
.
Starts an asynchronous job to transcribe speech to text.
Updates a vocabulary with new values that you provide in a different text file from the one you used to create the vocabulary.
Updates an existing vocabulary with new values.
Updates a vocabulary filter with a new list of filtered words.
.
Waiters polls an API operation until a resource enters a desired state.
Returns the list of supported waiters.
add_plugin, api, #build_request, clear_plugins, define, new, #operation, #operation_names, plugins, remove_plugin, set_api, set_plugins
Methods included from Seahorse::Client::HandlerBuilder#handle, #handle_request, #handle_response
Instance Method Details #create_language_model(options = {}) ⇒ Types::CreateLanguageModelResponseCreates a new custom language model. Use Amazon S3 prefixes to provide the location of your input files. The time it takes to create your model depends on the size of your training data.
#create_medical_vocabulary(options = {}) ⇒ Types::CreateMedicalVocabularyResponseCreates a new custom vocabulary that you can use to change how Amazon Transcribe Medical transcribes your audio file.
#create_vocabulary(options = {}) ⇒ Types::CreateVocabularyResponseCreates a new custom vocabulary that you can use to change the way Amazon Transcribe handles transcription of an audio file.
#create_vocabulary_filter(options = {}) ⇒ Types::CreateVocabularyFilterResponseCreates a new vocabulary filter that you can use to filter words, such as profane words, from the output of a transcription job.
#delete_language_model(options = {}) ⇒ StructDeletes a custom language model using its name.
#delete_medical_transcription_job(options = {}) ⇒ StructDeletes a transcription job generated by Amazon Transcribe Medical and any related information.
#delete_medical_vocabulary(options = {}) ⇒ StructDeletes a vocabulary from Amazon Transcribe Medical.
#delete_transcription_job(options = {}) ⇒ StructDeletes a previously submitted transcription job along with any other generated results such as the transcription, models, and so on.
#delete_vocabulary(options = {}) ⇒ StructDeletes a vocabulary from Amazon Transcribe.
#delete_vocabulary_filter(options = {}) ⇒ StructRemoves a vocabulary filter.
#describe_language_model(options = {}) ⇒ Types::DescribeLanguageModelResponseGets information about a single custom language model. Use this information to see details about the language model in your AWS account. You can also see whether the base language model used to create your custom language model has been updated. If Amazon Transcribe has updated the base model, you can create a new custom language model using the updated base model. If the language model wasn't created, you can use this operation to understand why Amazon Transcribe couldn't create it.
#get_medical_transcription_job(options = {}) ⇒ Types::GetMedicalTranscriptionJobResponseReturns information about a transcription job from Amazon Transcribe Medical. To see the status of the job, check the TranscriptionJobStatus
field. If the status is COMPLETED
, the job is finished. You find the results of the completed job in the TranscriptFileUri
field.
Returns information about a transcription job. To see the status of the job, check the TranscriptionJobStatus
field. If the status is COMPLETED
, the job is finished and you can find the results at the location specified in the TranscriptFileUri
field. If you enable content redaction, the redacted transcript appears in RedactedTranscriptFileUri
.
Provides more information about the custom language models you've created. You can use the information in this list to find a specific custom language model. You can then use the operation to get more information about it.
#list_medical_vocabularies(options = {}) ⇒ Types::ListMedicalVocabulariesResponseReturns a list of vocabularies that match the specified criteria. If you don't enter a value in any of the request parameters, returns the entire list of vocabularies.
#list_vocabularies(options = {}) ⇒ Types::ListVocabulariesResponseReturns a list of vocabularies that match the specified criteria. If no criteria are specified, returns the entire list of vocabularies.
#update_medical_vocabulary(options = {}) ⇒ Types::UpdateMedicalVocabularyResponseUpdates a vocabulary with new values that you provide in a different text file from the one you used to create the vocabulary. The UpdateMedicalVocabulary
operation overwrites all of the existing information with the values that you provide in the request.
Updates an existing vocabulary with new values. The UpdateVocabulary
operation overwrites all of the existing information with the values that you provide in the request.
Waiters polls an API operation until a resource enters a desired state.
Basic UsageWaiters will poll until they are succesful, they fail by entering a terminal state, or until a maximum number of attempts are made.
# polls in a loop, sleeping between attempts client.waiter_until(waiter_name, params)
ConfigurationYou can configure the maximum number of polling attempts, and the delay (in seconds) between each polling attempt. You configure waiters by passing a block to #wait_until:
# poll for ~25 seconds
client.wait_until(...) do |w|
w.max_attempts = 5
w.delay = 5
end
Callbacks
You can be notified before each polling attempt and before each delay. If you throw :success
or :failure
from these callbacks, it will terminate the waiter.
started_at = Time.now
client.wait_until(...) do |w|
# disable max attempts
w.max_attempts = nil
# poll for 1 hour, instead of a number of attempts
w.before_wait do |attempts, response|
throw :failure if Time.now - started_at > 3600
end
end
Handling Errors
When a waiter is successful, it returns true
. When a waiter fails, it raises an error. All errors raised extend from Waiters::Errors::WaiterFailed.
begin
client.wait_until(...)
rescue Aws::Waiters::Errors::WaiterFailed
# resource did not enter the desired state in time
end
#waiter_names ⇒ Array<Symbol>
Returns the list of supported waiters. The following table lists the supported waiters and the client method they call:
Waiter Name Client Method Default Delay: Default Max Attempts:RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4