transcribeservice

package
v1.14.27 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 13, 2018 License: Apache-2.0 Imports: 8 Imported by: 0

Documentation

Overview

Package transcribeservice provides the client and types for making API requests to Amazon Transcribe Service.

Operations and objects for transcribing speech to text.

See https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26 for more information on this service.

See transcribeservice package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/transcribeservice/

Using the Client

To contact Amazon Transcribe Service with the SDK use the New function to create a new service client. With that client you can make API requests to the service. These clients are safe to use concurrently.

See the SDK's documentation for more information on how to use the SDK. https://docs.aws.amazon.com/sdk-for-go/api/

See aws.Config documentation for more information on configuring SDK clients. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

See the Amazon Transcribe Service client TranscribeService for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/transcribeservice/#New

Index

Constants

View Source
const (
	// LanguageCodeEnUs is a LanguageCode enum value
	LanguageCodeEnUs = "en-US"

	// LanguageCodeEsUs is a LanguageCode enum value
	LanguageCodeEsUs = "es-US"
)
View Source
const (
	// MediaFormatMp3 is a MediaFormat enum value
	MediaFormatMp3 = "mp3"

	// MediaFormatMp4 is a MediaFormat enum value
	MediaFormatMp4 = "mp4"

	// MediaFormatWav is a MediaFormat enum value
	MediaFormatWav = "wav"

	// MediaFormatFlac is a MediaFormat enum value
	MediaFormatFlac = "flac"
)
View Source
const (
	// OutputLocationTypeCustomerBucket is a OutputLocationType enum value
	OutputLocationTypeCustomerBucket = "CUSTOMER_BUCKET"

	// OutputLocationTypeServiceBucket is a OutputLocationType enum value
	OutputLocationTypeServiceBucket = "SERVICE_BUCKET"
)
View Source
const (
	// TranscriptionJobStatusInProgress is a TranscriptionJobStatus enum value
	TranscriptionJobStatusInProgress = "IN_PROGRESS"

	// TranscriptionJobStatusFailed is a TranscriptionJobStatus enum value
	TranscriptionJobStatusFailed = "FAILED"

	// TranscriptionJobStatusCompleted is a TranscriptionJobStatus enum value
	TranscriptionJobStatusCompleted = "COMPLETED"
)
View Source
const (
	// VocabularyStatePending is a VocabularyState enum value
	VocabularyStatePending = "PENDING"

	// VocabularyStateReady is a VocabularyState enum value
	VocabularyStateReady = "READY"

	// VocabularyStateFailed is a VocabularyState enum value
	VocabularyStateFailed = "FAILED"
)
View Source
const (

	// ErrCodeBadRequestException for service response error code
	// "BadRequestException".
	//
	// Your request didn't pass one or more validation tests. For example, a name
	// already exists when creating a resource or a name may not exist when getting
	// a transcription job or custom vocabulary. See the exception Message field
	// for more information.
	ErrCodeBadRequestException = "BadRequestException"

	// ErrCodeConflictException for service response error code
	// "ConflictException".
	//
	// When you are using the StartTranscriptionJob operation, the JobName field
	// is a duplicate of a previously entered job name. Resend your request with
	// a different name.
	//
	// When you are using the UpdateVocabulary operation, there are two jobs running
	// at the same time. Resend the second request later.
	ErrCodeConflictException = "ConflictException"

	// ErrCodeInternalFailureException for service response error code
	// "InternalFailureException".
	//
	// There was an internal error. Check the error message and try your request
	// again.
	ErrCodeInternalFailureException = "InternalFailureException"

	// ErrCodeLimitExceededException for service response error code
	// "LimitExceededException".
	//
	// Either you have sent too many requests or your input file is too long. Wait
	// before you resend your request, or use a smaller file and resend the request.
	ErrCodeLimitExceededException = "LimitExceededException"

	// ErrCodeNotFoundException for service response error code
	// "NotFoundException".
	//
	// We can't find the requested resource. Check the name and try your request
	// again.
	ErrCodeNotFoundException = "NotFoundException"
)
View Source
const (
	ServiceName = "transcribe" // Name of service.
	EndpointsID = ServiceName  // ID to lookup a service endpoint with.
	ServiceID   = "Transcribe" // ServiceID is a unique identifer of a specific service.
)

Service information constants

Variables

This section is empty.

Functions

This section is empty.

Types

type CreateVocabularyInput added in v1.13.28

type CreateVocabularyInput struct {

	// The language code of the vocabulary entries.
	//
	// LanguageCode is a required field
	LanguageCode *string `type:"string" required:"true" enum:"LanguageCode"`

	// An array of strings that contains the vocabulary entries.
	//
	// Phrases is a required field
	Phrases []*string `type:"list" required:"true"`

	// The name of the vocabulary. The name must be unique within an AWS account.
	// The name is case-sensitive.
	//
	// VocabularyName is a required field
	VocabularyName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CreateVocabularyInput) GoString added in v1.13.28

func (s CreateVocabularyInput) GoString() string

GoString returns the string representation

func (*CreateVocabularyInput) SetLanguageCode added in v1.13.28

func (s *CreateVocabularyInput) SetLanguageCode(v string) *CreateVocabularyInput

SetLanguageCode sets the LanguageCode field's value.

func (*CreateVocabularyInput) SetPhrases added in v1.13.28

func (s *CreateVocabularyInput) SetPhrases(v []*string) *CreateVocabularyInput

SetPhrases sets the Phrases field's value.

func (*CreateVocabularyInput) SetVocabularyName added in v1.13.28

func (s *CreateVocabularyInput) SetVocabularyName(v string) *CreateVocabularyInput

SetVocabularyName sets the VocabularyName field's value.

func (CreateVocabularyInput) String added in v1.13.28

func (s CreateVocabularyInput) String() string

String returns the string representation

func (*CreateVocabularyInput) Validate added in v1.13.28

func (s *CreateVocabularyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateVocabularyOutput added in v1.13.28

type CreateVocabularyOutput struct {

	// If the VocabularyState field is FAILED, this field contains information about
	// why the job failed.
	FailureReason *string `type:"string"`

	// The language code of the vocabulary entries.
	LanguageCode *string `type:"string" enum:"LanguageCode"`

	// The date and time that the vocabulary was created.
	LastModifiedTime *time.Time `type:"timestamp" timestampFormat:"unix"`

	// The name of the vocabulary.
	VocabularyName *string `min:"1" type:"string"`

	// The processing state of the vocabulary. When the VocabularyState field contains
	// READY the vocabulary is ready to be used in a StartTranscriptionJob request.
	VocabularyState *string `type:"string" enum:"VocabularyState"`
	// contains filtered or unexported fields
}

func (CreateVocabularyOutput) GoString added in v1.13.28

func (s CreateVocabularyOutput) GoString() string

GoString returns the string representation

func (*CreateVocabularyOutput) SetFailureReason added in v1.13.28

func (s *CreateVocabularyOutput) SetFailureReason(v string) *CreateVocabularyOutput

SetFailureReason sets the FailureReason field's value.

func (*CreateVocabularyOutput) SetLanguageCode added in v1.13.28

func (s *CreateVocabularyOutput) SetLanguageCode(v string) *CreateVocabularyOutput

SetLanguageCode sets the LanguageCode field's value.

func (*CreateVocabularyOutput) SetLastModifiedTime added in v1.13.28

func (s *CreateVocabularyOutput) SetLastModifiedTime(v time.Time) *CreateVocabularyOutput

SetLastModifiedTime sets the LastModifiedTime field's value.

func (*CreateVocabularyOutput) SetVocabularyName added in v1.13.28

func (s *CreateVocabularyOutput) SetVocabularyName(v string) *CreateVocabularyOutput

SetVocabularyName sets the VocabularyName field's value.

func (*CreateVocabularyOutput) SetVocabularyState added in v1.13.28

func (s *CreateVocabularyOutput) SetVocabularyState(v string) *CreateVocabularyOutput

SetVocabularyState sets the VocabularyState field's value.

func (CreateVocabularyOutput) String added in v1.13.28

func (s CreateVocabularyOutput) String() string

String returns the string representation

type DeleteVocabularyInput added in v1.13.28

type DeleteVocabularyInput struct {

	// The name of the vocabulary to delete.
	//
	// VocabularyName is a required field
	VocabularyName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteVocabularyInput) GoString added in v1.13.28

func (s DeleteVocabularyInput) GoString() string

GoString returns the string representation

func (*DeleteVocabularyInput) SetVocabularyName added in v1.13.28

func (s *DeleteVocabularyInput) SetVocabularyName(v string) *DeleteVocabularyInput

SetVocabularyName sets the VocabularyName field's value.

func (DeleteVocabularyInput) String added in v1.13.28

func (s DeleteVocabularyInput) String() string

String returns the string representation

func (*DeleteVocabularyInput) Validate added in v1.13.28

func (s *DeleteVocabularyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteVocabularyOutput added in v1.13.28

type DeleteVocabularyOutput struct {
	// contains filtered or unexported fields
}

func (DeleteVocabularyOutput) GoString added in v1.13.28

func (s DeleteVocabularyOutput) GoString() string

GoString returns the string representation

func (DeleteVocabularyOutput) String added in v1.13.28

func (s DeleteVocabularyOutput) String() string

String returns the string representation

type GetTranscriptionJobInput

type GetTranscriptionJobInput struct {

	// The name of the job.
	//
	// TranscriptionJobName is a required field
	TranscriptionJobName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetTranscriptionJobInput) GoString

func (s GetTranscriptionJobInput) GoString() string

GoString returns the string representation

func (*GetTranscriptionJobInput) SetTranscriptionJobName

func (s *GetTranscriptionJobInput) SetTranscriptionJobName(v string) *GetTranscriptionJobInput

SetTranscriptionJobName sets the TranscriptionJobName field's value.

func (GetTranscriptionJobInput) String

func (s GetTranscriptionJobInput) String() string

String returns the string representation

func (*GetTranscriptionJobInput) Validate

func (s *GetTranscriptionJobInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetTranscriptionJobOutput

type GetTranscriptionJobOutput struct {

	// An object that contains the results of the transcription job.
	TranscriptionJob *TranscriptionJob `type:"structure"`
	// contains filtered or unexported fields
}

func (GetTranscriptionJobOutput) GoString

func (s GetTranscriptionJobOutput) GoString() string

GoString returns the string representation

func (*GetTranscriptionJobOutput) SetTranscriptionJob

SetTranscriptionJob sets the TranscriptionJob field's value.

func (GetTranscriptionJobOutput) String

func (s GetTranscriptionJobOutput) String() string

String returns the string representation

type GetVocabularyInput added in v1.13.28

type GetVocabularyInput struct {

	// The name of the vocabulary to return information about. The name is case-sensitive.
	//
	// VocabularyName is a required field
	VocabularyName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetVocabularyInput) GoString added in v1.13.28

func (s GetVocabularyInput) GoString() string

GoString returns the string representation

func (*GetVocabularyInput) SetVocabularyName added in v1.13.28

func (s *GetVocabularyInput) SetVocabularyName(v string) *GetVocabularyInput

SetVocabularyName sets the VocabularyName field's value.

func (GetVocabularyInput) String added in v1.13.28

func (s GetVocabularyInput) String() string

String returns the string representation

func (*GetVocabularyInput) Validate added in v1.13.28

func (s *GetVocabularyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetVocabularyOutput added in v1.13.28

type GetVocabularyOutput struct {

	// The S3 location where the vocabulary is stored. Use this URI to get the contents
	// of the vocabulary. The URI is available for a limited time.
	DownloadUri *string `min:"1" type:"string"`

	// If the VocabularyState field is FAILED, this field contains information about
	// why the job failed.
	FailureReason *string `type:"string"`

	// The language code of the vocabulary entries.
	LanguageCode *string `type:"string" enum:"LanguageCode"`

	// The date and time that the vocabulary was last modified.
	LastModifiedTime *time.Time `type:"timestamp" timestampFormat:"unix"`

	// The name of the vocabulary to return.
	VocabularyName *string `min:"1" type:"string"`

	// The processing state of the vocabulary.
	VocabularyState *string `type:"string" enum:"VocabularyState"`
	// contains filtered or unexported fields
}

func (GetVocabularyOutput) GoString added in v1.13.28

func (s GetVocabularyOutput) GoString() string

GoString returns the string representation

func (*GetVocabularyOutput) SetDownloadUri added in v1.13.28

func (s *GetVocabularyOutput) SetDownloadUri(v string) *GetVocabularyOutput

SetDownloadUri sets the DownloadUri field's value.

func (*GetVocabularyOutput) SetFailureReason added in v1.13.28

func (s *GetVocabularyOutput) SetFailureReason(v string) *GetVocabularyOutput

SetFailureReason sets the FailureReason field's value.

func (*GetVocabularyOutput) SetLanguageCode added in v1.13.28

func (s *GetVocabularyOutput) SetLanguageCode(v string) *GetVocabularyOutput

SetLanguageCode sets the LanguageCode field's value.

func (*GetVocabularyOutput) SetLastModifiedTime added in v1.13.28

func (s *GetVocabularyOutput) SetLastModifiedTime(v time.Time) *GetVocabularyOutput

SetLastModifiedTime sets the LastModifiedTime field's value.

func (*GetVocabularyOutput) SetVocabularyName added in v1.13.28

func (s *GetVocabularyOutput) SetVocabularyName(v string) *GetVocabularyOutput

SetVocabularyName sets the VocabularyName field's value.

func (*GetVocabularyOutput) SetVocabularyState added in v1.13.28

func (s *GetVocabularyOutput) SetVocabularyState(v string) *GetVocabularyOutput

SetVocabularyState sets the VocabularyState field's value.

func (GetVocabularyOutput) String added in v1.13.28

func (s GetVocabularyOutput) String() string

String returns the string representation

type ListTranscriptionJobsInput

type ListTranscriptionJobsInput struct {

	// When specified, the jobs returned in the list are limited to jobs whose name
	// contains the specified string.
	JobNameContains *string `min:"1" type:"string"`

	// The maximum number of jobs to return in the response. If there are fewer
	// results in the list, this response contains only the actual results.
	MaxResults *int64 `min:"1" type:"integer"`

	// If the result of the previous request to ListTranscriptionJobs was truncated,
	// include the NextToken to fetch the next set of jobs.
	NextToken *string `type:"string"`

	// When specified, returns only transcription jobs with the specified status.
	Status *string `type:"string" enum:"TranscriptionJobStatus"`
	// contains filtered or unexported fields
}

func (ListTranscriptionJobsInput) GoString

func (s ListTranscriptionJobsInput) GoString() string

GoString returns the string representation

func (*ListTranscriptionJobsInput) SetJobNameContains added in v1.13.28

SetJobNameContains sets the JobNameContains field's value.

func (*ListTranscriptionJobsInput) SetMaxResults

SetMaxResults sets the MaxResults field's value.

func (*ListTranscriptionJobsInput) SetNextToken

SetNextToken sets the NextToken field's value.

func (*ListTranscriptionJobsInput) SetStatus

SetStatus sets the Status field's value.

func (ListTranscriptionJobsInput) String

String returns the string representation

func (*ListTranscriptionJobsInput) Validate

func (s *ListTranscriptionJobsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListTranscriptionJobsOutput

type ListTranscriptionJobsOutput struct {

	// The ListTranscriptionJobs operation returns a page of jobs at a time. The
	// maximum size of the page is set by the MaxResults parameter. If there are
	// more jobs in the list than the page size, Amazon Transcribe returns the NextPage
	// token. Include the token in the next request to the ListTranscriptionJobs
	// operation to return in the next page of jobs.
	NextToken *string `type:"string"`

	// The requested status of the jobs returned.
	Status *string `type:"string" enum:"TranscriptionJobStatus"`

	// A list of objects containing summary information for a transcription job.
	TranscriptionJobSummaries []*TranscriptionJobSummary `type:"list"`
	// contains filtered or unexported fields
}

func (ListTranscriptionJobsOutput) GoString

func (s ListTranscriptionJobsOutput) GoString() string

GoString returns the string representation

func (*ListTranscriptionJobsOutput) SetNextToken

SetNextToken sets the NextToken field's value.

func (*ListTranscriptionJobsOutput) SetStatus

SetStatus sets the Status field's value.

func (*ListTranscriptionJobsOutput) SetTranscriptionJobSummaries

SetTranscriptionJobSummaries sets the TranscriptionJobSummaries field's value.

func (ListTranscriptionJobsOutput) String

String returns the string representation

type ListVocabulariesInput added in v1.13.28

type ListVocabulariesInput struct {

	// The maximum number of vocabularies to return in the response. If there are
	// fewer results in the list, this response contains only the actual results.
	MaxResults *int64 `min:"1" type:"integer"`

	// When specified, the vocabularies returned in the list are limited to vocabularies
	// whose name contains the specified string. The search is case-insensitive,
	// ListVocabularies will return both "vocabularyname" and "VocabularyName" in
	// the response list.
	NameContains *string `min:"1" type:"string"`

	// If the result of the previous request to ListVocabularies was truncated,
	// include the NextToken to fetch the next set of jobs.
	NextToken *string `type:"string"`

	// When specified, only returns vocabularies with the VocabularyState field
	// equal to the specified state.
	StateEquals *string `type:"string" enum:"VocabularyState"`
	// contains filtered or unexported fields
}

func (ListVocabulariesInput) GoString added in v1.13.28

func (s ListVocabulariesInput) GoString() string

GoString returns the string representation

func (*ListVocabulariesInput) SetMaxResults added in v1.13.28

func (s *ListVocabulariesInput) SetMaxResults(v int64) *ListVocabulariesInput

SetMaxResults sets the MaxResults field's value.

func (*ListVocabulariesInput) SetNameContains added in v1.13.28

func (s *ListVocabulariesInput) SetNameContains(v string) *ListVocabulariesInput

SetNameContains sets the NameContains field's value.

func (*ListVocabulariesInput) SetNextToken added in v1.13.28

SetNextToken sets the NextToken field's value.

func (*ListVocabulariesInput) SetStateEquals added in v1.13.28

func (s *ListVocabulariesInput) SetStateEquals(v string) *ListVocabulariesInput

SetStateEquals sets the StateEquals field's value.

func (ListVocabulariesInput) String added in v1.13.28

func (s ListVocabulariesInput) String() string

String returns the string representation

func (*ListVocabulariesInput) Validate added in v1.13.28

func (s *ListVocabulariesInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListVocabulariesOutput added in v1.13.28

type ListVocabulariesOutput struct {

	// The ListVocabularies operation returns a page of vocabularies at a time.
	// The maximum size of the page is set by the MaxResults parameter. If there
	// are more jobs in the list than the page size, Amazon Transcribe returns the
	// NextPage token. Include the token in the next request to the ListVocabularies
	// operation to return in the next page of jobs.
	NextToken *string `type:"string"`

	// The requested vocabulary state.
	Status *string `type:"string" enum:"TranscriptionJobStatus"`

	// A list of objects that describe the vocabularies that match the search criteria
	// in the request.
	Vocabularies []*VocabularyInfo `type:"list"`
	// contains filtered or unexported fields
}

func (ListVocabulariesOutput) GoString added in v1.13.28

func (s ListVocabulariesOutput) GoString() string

GoString returns the string representation

func (*ListVocabulariesOutput) SetNextToken added in v1.13.28

SetNextToken sets the NextToken field's value.

func (*ListVocabulariesOutput) SetStatus added in v1.13.28

SetStatus sets the Status field's value.

func (*ListVocabulariesOutput) SetVocabularies added in v1.13.28

SetVocabularies sets the Vocabularies field's value.

func (ListVocabulariesOutput) String added in v1.13.28

func (s ListVocabulariesOutput) String() string

String returns the string representation

type Media

type Media struct {

	// The S3 location of the input media file. The URI must be in the same region
	// as the API endpoint that you are calling. The general form is:
	//
	// https://<aws-region>.amazonaws.com/<bucket-name>/<keyprefix>/<objectkey>
	//
	// For example:
	//
	// https://s3-us-east-1.amazonaws.com/examplebucket/example.mp4
	//
	// https://s3-us-east-1.amazonaws.com/examplebucket/mediadocs/example.mp4
	//
	// For more information about S3 object names, see Object Keys (http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#object-keys)
	// in the Amazon S3 Developer Guide.
	MediaFileUri *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Describes the input media file in a transcription request.

func (Media) GoString

func (s Media) GoString() string

GoString returns the string representation

func (*Media) SetMediaFileUri

func (s *Media) SetMediaFileUri(v string) *Media

SetMediaFileUri sets the MediaFileUri field's value.

func (Media) String

func (s Media) String() string

String returns the string representation

func (*Media) Validate

func (s *Media) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type Settings added in v1.13.28

type Settings struct {

	// The maximum number of speakers to identify in the input audio. If there are
	// more speakers in the audio than this number, multiple speakers will be identified
	// as a single speaker. If you specify the MaxSpeakerLabels field, you must
	// set the ShowSpeakerLabels field to true.
	MaxSpeakerLabels *int64 `min:"2" type:"integer"`

	// Determines whether the transcription job should use speaker recognition to
	// identify different speakers in the input audio. If you set the ShowSpeakerLabels
	// field to true, you must also set the maximum number of speaker labels MaxSpeakerLabels
	// field.
	ShowSpeakerLabels *bool `type:"boolean"`

	// The name of a vocabulary to use when processing the transcription job.
	VocabularyName *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Provides optional settings for the StartTranscriptionJob operation.

func (Settings) GoString added in v1.13.28

func (s Settings) GoString() string

GoString returns the string representation

func (*Settings) SetMaxSpeakerLabels added in v1.13.28

func (s *Settings) SetMaxSpeakerLabels(v int64) *Settings

SetMaxSpeakerLabels sets the MaxSpeakerLabels field's value.

func (*Settings) SetShowSpeakerLabels added in v1.13.28

func (s *Settings) SetShowSpeakerLabels(v bool) *Settings

SetShowSpeakerLabels sets the ShowSpeakerLabels field's value.

func (*Settings) SetVocabularyName added in v1.13.28

func (s *Settings) SetVocabularyName(v string) *Settings

SetVocabularyName sets the VocabularyName field's value.

func (Settings) String added in v1.13.28

func (s Settings) String() string

String returns the string representation

func (*Settings) Validate added in v1.13.28

func (s *Settings) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type StartTranscriptionJobInput

type StartTranscriptionJobInput struct {

	// The language code for the language used in the input media file.
	//
	// LanguageCode is a required field
	LanguageCode *string `type:"string" required:"true" enum:"LanguageCode"`

	// An object that describes the input media for a transcription job.
	//
	// Media is a required field
	Media *Media `type:"structure" required:"true"`

	// The format of the input media file.
	//
	// MediaFormat is a required field
	MediaFormat *string `type:"string" required:"true" enum:"MediaFormat"`

	// The sample rate, in Hertz, of the audio track in the input media file.
	MediaSampleRateHertz *int64 `min:"8000" type:"integer"`

	// The location where the transcription is stored.
	//
	// If you set the OutputBucketName, Amazon Transcribe puts the transcription
	// in the specified S3 bucket. When you call the GetTranscriptionJob operation,
	// the operation returns this location in the TranscriptFileUri field. The S3
	// bucket must have permissions that allow Amazon Transcribe to put files in
	// the bucket. For more information, see Permissions Required for IAM User Roles
	// (https://docs.aws.amazon.com/transcribe/latest/dg/access-control-managing-permissions.html#auth-role-iam-user).
	//
	// If you don't set the OutputBucketName, Amazon Transcribe generates a pre-signed
	// URL, a shareable URL that provides secure access to your transcription, and
	// returns it in the TranscriptFileUri field. Use this URL to download the transcription.
	OutputBucketName *string `type:"string"`

	// A Settings object that provides optional settings for a transcription job.
	Settings *Settings `type:"structure"`

	// The name of the job. You can't use the strings "." or ".." in the job name.
	// The name must be unique within an AWS account.
	//
	// TranscriptionJobName is a required field
	TranscriptionJobName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (StartTranscriptionJobInput) GoString

func (s StartTranscriptionJobInput) GoString() string

GoString returns the string representation

func (*StartTranscriptionJobInput) SetLanguageCode

SetLanguageCode sets the LanguageCode field's value.

func (*StartTranscriptionJobInput) SetMedia

SetMedia sets the Media field's value.

func (*StartTranscriptionJobInput) SetMediaFormat

SetMediaFormat sets the MediaFormat field's value.

func (*StartTranscriptionJobInput) SetMediaSampleRateHertz

func (s *StartTranscriptionJobInput) SetMediaSampleRateHertz(v int64) *StartTranscriptionJobInput

SetMediaSampleRateHertz sets the MediaSampleRateHertz field's value.

func (*StartTranscriptionJobInput) SetOutputBucketName added in v1.14.22

SetOutputBucketName sets the OutputBucketName field's value.

func (*StartTranscriptionJobInput) SetSettings added in v1.13.28

SetSettings sets the Settings field's value.

func (*StartTranscriptionJobInput) SetTranscriptionJobName

func (s *StartTranscriptionJobInput) SetTranscriptionJobName(v string) *StartTranscriptionJobInput

SetTranscriptionJobName sets the TranscriptionJobName field's value.

func (StartTranscriptionJobInput) String

String returns the string representation

func (*StartTranscriptionJobInput) Validate

func (s *StartTranscriptionJobInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type StartTranscriptionJobOutput

type StartTranscriptionJobOutput struct {

	// An object containing details of the asynchronous transcription job.
	TranscriptionJob *TranscriptionJob `type:"structure"`
	// contains filtered or unexported fields
}

func (StartTranscriptionJobOutput) GoString

func (s StartTranscriptionJobOutput) GoString() string

GoString returns the string representation

func (*StartTranscriptionJobOutput) SetTranscriptionJob

SetTranscriptionJob sets the TranscriptionJob field's value.

func (StartTranscriptionJobOutput) String

String returns the string representation

type TranscribeService

type TranscribeService struct {
	*client.Client
}

TranscribeService provides the API operation methods for making requests to Amazon Transcribe Service. See this package's package overview docs for details on the service.

TranscribeService methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.

func New

New creates a new instance of the TranscribeService client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.

Example:

// Create a TranscribeService client from just a session.
svc := transcribeservice.New(mySession)

// Create a TranscribeService client with additional configuration
svc := transcribeservice.New(mySession, aws.NewConfig().WithRegion("us-west-2"))

func (*TranscribeService) CreateVocabulary added in v1.13.28

func (c *TranscribeService) CreateVocabulary(input *CreateVocabularyInput) (*CreateVocabularyOutput, error)

CreateVocabulary API operation for Amazon Transcribe Service.

Creates a new custom vocabulary that you can use to change the way Amazon Transcribe handles transcription of an audio file.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Transcribe Service's API operation CreateVocabulary for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" Your request didn't pass one or more validation tests. For example, a name already exists when creating a resource or a name may not exist when getting a transcription job or custom vocabulary. See the exception Message field for more information.

  • ErrCodeLimitExceededException "LimitExceededException" Either you have sent too many requests or your input file is too long. Wait before you resend your request, or use a smaller file and resend the request.

  • ErrCodeInternalFailureException "InternalFailureException" There was an internal error. Check the error message and try your request again.

  • ErrCodeConflictException "ConflictException" When you are using the StartTranscriptionJob operation, the JobName field is a duplicate of a previously entered job name. Resend your request with a different name.

    When you are using the UpdateVocabulary operation, there are two jobs running at the same time. Resend the second request later.

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/CreateVocabulary

func (*TranscribeService) CreateVocabularyRequest added in v1.13.28

func (c *TranscribeService) CreateVocabularyRequest(input *CreateVocabularyInput) (req *request.Request, output *CreateVocabularyOutput)

CreateVocabularyRequest generates a "aws/request.Request" representing the client's request for the CreateVocabulary operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateVocabulary for more information on using the CreateVocabulary API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateVocabularyRequest method.
req, resp := client.CreateVocabularyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/CreateVocabulary

func (*TranscribeService) CreateVocabularyWithContext added in v1.13.28

func (c *TranscribeService) CreateVocabularyWithContext(ctx aws.Context, input *CreateVocabularyInput, opts ...request.Option) (*CreateVocabularyOutput, error)

CreateVocabularyWithContext is the same as CreateVocabulary with the addition of the ability to pass a context and additional request options.

See CreateVocabulary for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*TranscribeService) DeleteVocabulary added in v1.13.28

func (c *TranscribeService) DeleteVocabulary(input *DeleteVocabularyInput) (*DeleteVocabularyOutput, error)

DeleteVocabulary API operation for Amazon Transcribe Service.

Deletes a vocabulary from Amazon Transcribe.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Transcribe Service's API operation DeleteVocabulary for usage and error information.

Returned Error Codes:

  • ErrCodeNotFoundException "NotFoundException" We can't find the requested resource. Check the name and try your request again.

  • ErrCodeLimitExceededException "LimitExceededException" Either you have sent too many requests or your input file is too long. Wait before you resend your request, or use a smaller file and resend the request.

  • ErrCodeBadRequestException "BadRequestException" Your request didn't pass one or more validation tests. For example, a name already exists when creating a resource or a name may not exist when getting a transcription job or custom vocabulary. See the exception Message field for more information.

  • ErrCodeInternalFailureException "InternalFailureException" There was an internal error. Check the error message and try your request again.

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/DeleteVocabulary

func (*TranscribeService) DeleteVocabularyRequest added in v1.13.28

func (c *TranscribeService) DeleteVocabularyRequest(input *DeleteVocabularyInput) (req *request.Request, output *DeleteVocabularyOutput)

DeleteVocabularyRequest generates a "aws/request.Request" representing the client's request for the DeleteVocabulary operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteVocabulary for more information on using the DeleteVocabulary API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteVocabularyRequest method.
req, resp := client.DeleteVocabularyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/DeleteVocabulary

func (*TranscribeService) DeleteVocabularyWithContext added in v1.13.28

func (c *TranscribeService) DeleteVocabularyWithContext(ctx aws.Context, input *DeleteVocabularyInput, opts ...request.Option) (*DeleteVocabularyOutput, error)

DeleteVocabularyWithContext is the same as DeleteVocabulary with the addition of the ability to pass a context and additional request options.

See DeleteVocabulary for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*TranscribeService) GetTranscriptionJob

GetTranscriptionJob API operation for Amazon Transcribe Service.

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 TranscriptionFileUri field.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Transcribe Service's API operation GetTranscriptionJob for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" Your request didn't pass one or more validation tests. For example, a name already exists when creating a resource or a name may not exist when getting a transcription job or custom vocabulary. See the exception Message field for more information.

  • ErrCodeLimitExceededException "LimitExceededException" Either you have sent too many requests or your input file is too long. Wait before you resend your request, or use a smaller file and resend the request.

  • ErrCodeInternalFailureException "InternalFailureException" There was an internal error. Check the error message and try your request again.

  • ErrCodeNotFoundException "NotFoundException" We can't find the requested resource. Check the name and try your request again.

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/GetTranscriptionJob

func (*TranscribeService) GetTranscriptionJobRequest

func (c *TranscribeService) GetTranscriptionJobRequest(input *GetTranscriptionJobInput) (req *request.Request, output *GetTranscriptionJobOutput)

GetTranscriptionJobRequest generates a "aws/request.Request" representing the client's request for the GetTranscriptionJob operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetTranscriptionJob for more information on using the GetTranscriptionJob API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetTranscriptionJobRequest method.
req, resp := client.GetTranscriptionJobRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/GetTranscriptionJob

func (*TranscribeService) GetTranscriptionJobWithContext

func (c *TranscribeService) GetTranscriptionJobWithContext(ctx aws.Context, input *GetTranscriptionJobInput, opts ...request.Option) (*GetTranscriptionJobOutput, error)

GetTranscriptionJobWithContext is the same as GetTranscriptionJob with the addition of the ability to pass a context and additional request options.

See GetTranscriptionJob for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*TranscribeService) GetVocabulary added in v1.13.28

func (c *TranscribeService) GetVocabulary(input *GetVocabularyInput) (*GetVocabularyOutput, error)

GetVocabulary API operation for Amazon Transcribe Service.

Gets information about a vocabulary.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Transcribe Service's API operation GetVocabulary for usage and error information.

Returned Error Codes:

  • ErrCodeNotFoundException "NotFoundException" We can't find the requested resource. Check the name and try your request again.

  • ErrCodeLimitExceededException "LimitExceededException" Either you have sent too many requests or your input file is too long. Wait before you resend your request, or use a smaller file and resend the request.

  • ErrCodeInternalFailureException "InternalFailureException" There was an internal error. Check the error message and try your request again.

  • ErrCodeBadRequestException "BadRequestException" Your request didn't pass one or more validation tests. For example, a name already exists when creating a resource or a name may not exist when getting a transcription job or custom vocabulary. See the exception Message field for more information.

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/GetVocabulary

func (*TranscribeService) GetVocabularyRequest added in v1.13.28

func (c *TranscribeService) GetVocabularyRequest(input *GetVocabularyInput) (req *request.Request, output *GetVocabularyOutput)

GetVocabularyRequest generates a "aws/request.Request" representing the client's request for the GetVocabulary operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetVocabulary for more information on using the GetVocabulary API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetVocabularyRequest method.
req, resp := client.GetVocabularyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/GetVocabulary

func (*TranscribeService) GetVocabularyWithContext added in v1.13.28

func (c *TranscribeService) GetVocabularyWithContext(ctx aws.Context, input *GetVocabularyInput, opts ...request.Option) (*GetVocabularyOutput, error)

GetVocabularyWithContext is the same as GetVocabulary with the addition of the ability to pass a context and additional request options.

See GetVocabulary for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*TranscribeService) ListTranscriptionJobs

ListTranscriptionJobs API operation for Amazon Transcribe Service.

Lists transcription jobs with the specified status.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Transcribe Service's API operation ListTranscriptionJobs for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" Your request didn't pass one or more validation tests. For example, a name already exists when creating a resource or a name may not exist when getting a transcription job or custom vocabulary. See the exception Message field for more information.

  • ErrCodeLimitExceededException "LimitExceededException" Either you have sent too many requests or your input file is too long. Wait before you resend your request, or use a smaller file and resend the request.

  • ErrCodeInternalFailureException "InternalFailureException" There was an internal error. Check the error message and try your request again.

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/ListTranscriptionJobs

func (*TranscribeService) ListTranscriptionJobsPages

func (c *TranscribeService) ListTranscriptionJobsPages(input *ListTranscriptionJobsInput, fn func(*ListTranscriptionJobsOutput, bool) bool) error

ListTranscriptionJobsPages iterates over the pages of a ListTranscriptionJobs operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListTranscriptionJobs method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListTranscriptionJobs operation.
pageNum := 0
err := client.ListTranscriptionJobsPages(params,
    func(page *ListTranscriptionJobsOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*TranscribeService) ListTranscriptionJobsPagesWithContext

func (c *TranscribeService) ListTranscriptionJobsPagesWithContext(ctx aws.Context, input *ListTranscriptionJobsInput, fn func(*ListTranscriptionJobsOutput, bool) bool, opts ...request.Option) error

ListTranscriptionJobsPagesWithContext same as ListTranscriptionJobsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*TranscribeService) ListTranscriptionJobsRequest

func (c *TranscribeService) ListTranscriptionJobsRequest(input *ListTranscriptionJobsInput) (req *request.Request, output *ListTranscriptionJobsOutput)

ListTranscriptionJobsRequest generates a "aws/request.Request" representing the client's request for the ListTranscriptionJobs operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListTranscriptionJobs for more information on using the ListTranscriptionJobs API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListTranscriptionJobsRequest method.
req, resp := client.ListTranscriptionJobsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/ListTranscriptionJobs

func (*TranscribeService) ListTranscriptionJobsWithContext

func (c *TranscribeService) ListTranscriptionJobsWithContext(ctx aws.Context, input *ListTranscriptionJobsInput, opts ...request.Option) (*ListTranscriptionJobsOutput, error)

ListTranscriptionJobsWithContext is the same as ListTranscriptionJobs with the addition of the ability to pass a context and additional request options.

See ListTranscriptionJobs for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*TranscribeService) ListVocabularies added in v1.13.28

func (c *TranscribeService) ListVocabularies(input *ListVocabulariesInput) (*ListVocabulariesOutput, error)

ListVocabularies API operation for Amazon Transcribe Service.

Returns a list of vocabularies that match the specified criteria. If no criteria are specified, returns the entire list of vocabularies.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Transcribe Service's API operation ListVocabularies for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" Your request didn't pass one or more validation tests. For example, a name already exists when creating a resource or a name may not exist when getting a transcription job or custom vocabulary. See the exception Message field for more information.

  • ErrCodeLimitExceededException "LimitExceededException" Either you have sent too many requests or your input file is too long. Wait before you resend your request, or use a smaller file and resend the request.

  • ErrCodeInternalFailureException "InternalFailureException" There was an internal error. Check the error message and try your request again.

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/ListVocabularies

func (*TranscribeService) ListVocabulariesPages added in v1.13.28

func (c *TranscribeService) ListVocabulariesPages(input *ListVocabulariesInput, fn func(*ListVocabulariesOutput, bool) bool) error

ListVocabulariesPages iterates over the pages of a ListVocabularies operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListVocabularies method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListVocabularies operation.
pageNum := 0
err := client.ListVocabulariesPages(params,
    func(page *ListVocabulariesOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*TranscribeService) ListVocabulariesPagesWithContext added in v1.13.28

func (c *TranscribeService) ListVocabulariesPagesWithContext(ctx aws.Context, input *ListVocabulariesInput, fn func(*ListVocabulariesOutput, bool) bool, opts ...request.Option) error

ListVocabulariesPagesWithContext same as ListVocabulariesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*TranscribeService) ListVocabulariesRequest added in v1.13.28

func (c *TranscribeService) ListVocabulariesRequest(input *ListVocabulariesInput) (req *request.Request, output *ListVocabulariesOutput)

ListVocabulariesRequest generates a "aws/request.Request" representing the client's request for the ListVocabularies operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListVocabularies for more information on using the ListVocabularies API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListVocabulariesRequest method.
req, resp := client.ListVocabulariesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/ListVocabularies

func (*TranscribeService) ListVocabulariesWithContext added in v1.13.28

func (c *TranscribeService) ListVocabulariesWithContext(ctx aws.Context, input *ListVocabulariesInput, opts ...request.Option) (*ListVocabulariesOutput, error)

ListVocabulariesWithContext is the same as ListVocabularies with the addition of the ability to pass a context and additional request options.

See ListVocabularies for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*TranscribeService) StartTranscriptionJob

StartTranscriptionJob API operation for Amazon Transcribe Service.

Starts an asynchronous job to transcribe speech to text.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Transcribe Service's API operation StartTranscriptionJob for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" Your request didn't pass one or more validation tests. For example, a name already exists when creating a resource or a name may not exist when getting a transcription job or custom vocabulary. See the exception Message field for more information.

  • ErrCodeLimitExceededException "LimitExceededException" Either you have sent too many requests or your input file is too long. Wait before you resend your request, or use a smaller file and resend the request.

  • ErrCodeInternalFailureException "InternalFailureException" There was an internal error. Check the error message and try your request again.

  • ErrCodeConflictException "ConflictException" When you are using the StartTranscriptionJob operation, the JobName field is a duplicate of a previously entered job name. Resend your request with a different name.

    When you are using the UpdateVocabulary operation, there are two jobs running at the same time. Resend the second request later.

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/StartTranscriptionJob

func (*TranscribeService) StartTranscriptionJobRequest

func (c *TranscribeService) StartTranscriptionJobRequest(input *StartTranscriptionJobInput) (req *request.Request, output *StartTranscriptionJobOutput)

StartTranscriptionJobRequest generates a "aws/request.Request" representing the client's request for the StartTranscriptionJob operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See StartTranscriptionJob for more information on using the StartTranscriptionJob API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the StartTranscriptionJobRequest method.
req, resp := client.StartTranscriptionJobRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/StartTranscriptionJob

func (*TranscribeService) StartTranscriptionJobWithContext

func (c *TranscribeService) StartTranscriptionJobWithContext(ctx aws.Context, input *StartTranscriptionJobInput, opts ...request.Option) (*StartTranscriptionJobOutput, error)

StartTranscriptionJobWithContext is the same as StartTranscriptionJob with the addition of the ability to pass a context and additional request options.

See StartTranscriptionJob for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*TranscribeService) UpdateVocabulary added in v1.13.28

func (c *TranscribeService) UpdateVocabulary(input *UpdateVocabularyInput) (*UpdateVocabularyOutput, error)

UpdateVocabulary API operation for Amazon Transcribe Service.

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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Transcribe Service's API operation UpdateVocabulary for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" Your request didn't pass one or more validation tests. For example, a name already exists when creating a resource or a name may not exist when getting a transcription job or custom vocabulary. See the exception Message field for more information.

  • ErrCodeLimitExceededException "LimitExceededException" Either you have sent too many requests or your input file is too long. Wait before you resend your request, or use a smaller file and resend the request.

  • ErrCodeInternalFailureException "InternalFailureException" There was an internal error. Check the error message and try your request again.

  • ErrCodeNotFoundException "NotFoundException" We can't find the requested resource. Check the name and try your request again.

  • ErrCodeConflictException "ConflictException" When you are using the StartTranscriptionJob operation, the JobName field is a duplicate of a previously entered job name. Resend your request with a different name.

    When you are using the UpdateVocabulary operation, there are two jobs running at the same time. Resend the second request later.

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/UpdateVocabulary

func (*TranscribeService) UpdateVocabularyRequest added in v1.13.28

func (c *TranscribeService) UpdateVocabularyRequest(input *UpdateVocabularyInput) (req *request.Request, output *UpdateVocabularyOutput)

UpdateVocabularyRequest generates a "aws/request.Request" representing the client's request for the UpdateVocabulary operation. The "output" return value will be populated with the request's response once the request completes successfuly.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateVocabulary for more information on using the UpdateVocabulary API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateVocabularyRequest method.
req, resp := client.UpdateVocabularyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/transcribe-2017-10-26/UpdateVocabulary

func (*TranscribeService) UpdateVocabularyWithContext added in v1.13.28

func (c *TranscribeService) UpdateVocabularyWithContext(ctx aws.Context, input *UpdateVocabularyInput, opts ...request.Option) (*UpdateVocabularyOutput, error)

UpdateVocabularyWithContext is the same as UpdateVocabulary with the addition of the ability to pass a context and additional request options.

See UpdateVocabulary for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

type Transcript

type Transcript struct {

	// The location where the transcription is stored.
	//
	// Use this URI to access the transcription. If you specified an S3 bucket in
	// the OutputBucketName field when you created the job, this is the URI of that
	// bucket. If you chose to store the transcription in Amazon Transcribe, this
	// is a shareable URL that provides secure access to that location.
	TranscriptFileUri *string `min:"1" type:"string"`
	// contains filtered or unexported fields
}

Identifies the location of a transcription.

func (Transcript) GoString

func (s Transcript) GoString() string

GoString returns the string representation

func (*Transcript) SetTranscriptFileUri

func (s *Transcript) SetTranscriptFileUri(v string) *Transcript

SetTranscriptFileUri sets the TranscriptFileUri field's value.

func (Transcript) String

func (s Transcript) String() string

String returns the string representation

type TranscriptionJob

type TranscriptionJob struct {

	// A timestamp that shows when the job was completed.
	CompletionTime *time.Time `type:"timestamp" timestampFormat:"unix"`

	// A timestamp that shows when the job was created.
	CreationTime *time.Time `type:"timestamp" timestampFormat:"unix"`

	// If the TranscriptionJobStatus field is FAILED, this field contains information
	// about why the job failed.
	FailureReason *string `type:"string"`

	// The language code for the input speech.
	LanguageCode *string `type:"string" enum:"LanguageCode"`

	// An object that describes the input media for the transcription job.
	Media *Media `type:"structure"`

	// The format of the input media file.
	MediaFormat *string `type:"string" enum:"MediaFormat"`

	// The sample rate, in Hertz, of the audio track in the input media file.
	MediaSampleRateHertz *int64 `min:"8000" type:"integer"`

	// Optional settings for the transcription job. Use these settings to turn on
	// speaker recognition, to set the maximum number of speakers that should be
	// identified and to specify a custom vocabulary to use when processing the
	// transcription job.
	Settings *Settings `type:"structure"`

	// An object that describes the output of the transcription job.
	Transcript *Transcript `type:"structure"`

	// The name of the transcription job.
	TranscriptionJobName *string `min:"1" type:"string"`

	// The status of the transcription job.
	TranscriptionJobStatus *string `type:"string" enum:"TranscriptionJobStatus"`
	// contains filtered or unexported fields
}

Describes an asynchronous transcription job that was created with the StartTranscriptionJob operation.

func (TranscriptionJob) GoString

func (s TranscriptionJob) GoString() string

GoString returns the string representation

func (*TranscriptionJob) SetCompletionTime

func (s *TranscriptionJob) SetCompletionTime(v time.Time) *TranscriptionJob

SetCompletionTime sets the CompletionTime field's value.

func (*TranscriptionJob) SetCreationTime

func (s *TranscriptionJob) SetCreationTime(v time.Time) *TranscriptionJob

SetCreationTime sets the CreationTime field's value.

func (*TranscriptionJob) SetFailureReason

func (s *TranscriptionJob) SetFailureReason(v string) *TranscriptionJob

SetFailureReason sets the FailureReason field's value.

func (*TranscriptionJob) SetLanguageCode

func (s *TranscriptionJob) SetLanguageCode(v string) *TranscriptionJob

SetLanguageCode sets the LanguageCode field's value.

func (*TranscriptionJob) SetMedia

func (s *TranscriptionJob) SetMedia(v *Media) *TranscriptionJob

SetMedia sets the Media field's value.

func (*TranscriptionJob) SetMediaFormat

func (s *TranscriptionJob) SetMediaFormat(v string) *TranscriptionJob

SetMediaFormat sets the MediaFormat field's value.

func (*TranscriptionJob) SetMediaSampleRateHertz

func (s *TranscriptionJob) SetMediaSampleRateHertz(v int64) *TranscriptionJob

SetMediaSampleRateHertz sets the MediaSampleRateHertz field's value.

func (*TranscriptionJob) SetSettings added in v1.13.28

func (s *TranscriptionJob) SetSettings(v *Settings) *TranscriptionJob

SetSettings sets the Settings field's value.

func (*TranscriptionJob) SetTranscript

func (s *TranscriptionJob) SetTranscript(v *Transcript) *TranscriptionJob

SetTranscript sets the Transcript field's value.

func (*TranscriptionJob) SetTranscriptionJobName

func (s *TranscriptionJob) SetTranscriptionJobName(v string) *TranscriptionJob

SetTranscriptionJobName sets the TranscriptionJobName field's value.

func (*TranscriptionJob) SetTranscriptionJobStatus

func (s *TranscriptionJob) SetTranscriptionJobStatus(v string) *TranscriptionJob

SetTranscriptionJobStatus sets the TranscriptionJobStatus field's value.

func (TranscriptionJob) String

func (s TranscriptionJob) String() string

String returns the string representation

type TranscriptionJobSummary

type TranscriptionJobSummary struct {

	// A timestamp that shows when the job was completed.
	CompletionTime *time.Time `type:"timestamp" timestampFormat:"unix"`

	// A timestamp that shows when the job was created.
	CreationTime *time.Time `type:"timestamp" timestampFormat:"unix"`

	// If the TranscriptionJobStatus field is FAILED, a description of the error.
	FailureReason *string `type:"string"`

	// The language code for the input speech.
	LanguageCode *string `type:"string" enum:"LanguageCode"`

	// Indicates the location of the output of the transcription job.
	//
	// If the value is CUSTOMER_BUCKET then the location is the S3 bucket specified
	// in the outputBucketName field when the transcription job was started with
	// the StartTranscriptionJob operation.
	//
	// If the value is SERVICE_BUCKET then the output is stored by Amazon Transcribe
	// and can be retrieved using the URI in the GetTranscriptionJob response's
	// TranscriptFileUri field.
	OutputLocationType *string `type:"string" enum:"OutputLocationType"`

	// The name of the transcription job.
	TranscriptionJobName *string `min:"1" type:"string"`

	// The status of the transcription job. When the status is COMPLETED, use the
	// GetTranscriptionJob operation to get the results of the transcription.
	TranscriptionJobStatus *string `type:"string" enum:"TranscriptionJobStatus"`
	// contains filtered or unexported fields
}

Provides a summary of information about a transcription job.

func (TranscriptionJobSummary) GoString

func (s TranscriptionJobSummary) GoString() string

GoString returns the string representation

func (*TranscriptionJobSummary) SetCompletionTime

func (s *TranscriptionJobSummary) SetCompletionTime(v time.Time) *TranscriptionJobSummary

SetCompletionTime sets the CompletionTime field's value.

func (*TranscriptionJobSummary) SetCreationTime

SetCreationTime sets the CreationTime field's value.

func (*TranscriptionJobSummary) SetFailureReason

func (s *TranscriptionJobSummary) SetFailureReason(v string) *TranscriptionJobSummary

SetFailureReason sets the FailureReason field's value.

func (*TranscriptionJobSummary) SetLanguageCode

SetLanguageCode sets the LanguageCode field's value.

func (*TranscriptionJobSummary) SetOutputLocationType added in v1.14.22

func (s *TranscriptionJobSummary) SetOutputLocationType(v string) *TranscriptionJobSummary

SetOutputLocationType sets the OutputLocationType field's value.

func (*TranscriptionJobSummary) SetTranscriptionJobName

func (s *TranscriptionJobSummary) SetTranscriptionJobName(v string) *TranscriptionJobSummary

SetTranscriptionJobName sets the TranscriptionJobName field's value.

func (*TranscriptionJobSummary) SetTranscriptionJobStatus

func (s *TranscriptionJobSummary) SetTranscriptionJobStatus(v string) *TranscriptionJobSummary

SetTranscriptionJobStatus sets the TranscriptionJobStatus field's value.

func (TranscriptionJobSummary) String

func (s TranscriptionJobSummary) String() string

String returns the string representation

type UpdateVocabularyInput added in v1.13.28

type UpdateVocabularyInput struct {

	// The language code of the vocabulary entries.
	//
	// LanguageCode is a required field
	LanguageCode *string `type:"string" required:"true" enum:"LanguageCode"`

	// An array of strings containing the vocabulary entries.
	//
	// Phrases is a required field
	Phrases []*string `type:"list" required:"true"`

	// The name of the vocabulary to update. The name is case-sensitive.
	//
	// VocabularyName is a required field
	VocabularyName *string `min:"1" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (UpdateVocabularyInput) GoString added in v1.13.28

func (s UpdateVocabularyInput) GoString() string

GoString returns the string representation

func (*UpdateVocabularyInput) SetLanguageCode added in v1.13.28

func (s *UpdateVocabularyInput) SetLanguageCode(v string) *UpdateVocabularyInput

SetLanguageCode sets the LanguageCode field's value.

func (*UpdateVocabularyInput) SetPhrases added in v1.13.28

func (s *UpdateVocabularyInput) SetPhrases(v []*string) *UpdateVocabularyInput

SetPhrases sets the Phrases field's value.

func (*UpdateVocabularyInput) SetVocabularyName added in v1.13.28

func (s *UpdateVocabularyInput) SetVocabularyName(v string) *UpdateVocabularyInput

SetVocabularyName sets the VocabularyName field's value.

func (UpdateVocabularyInput) String added in v1.13.28

func (s UpdateVocabularyInput) String() string

String returns the string representation

func (*UpdateVocabularyInput) Validate added in v1.13.28

func (s *UpdateVocabularyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UpdateVocabularyOutput added in v1.13.28

type UpdateVocabularyOutput struct {

	// The language code of the vocabulary entries.
	LanguageCode *string `type:"string" enum:"LanguageCode"`

	// The date and time that the vocabulary was updated.
	LastModifiedTime *time.Time `type:"timestamp" timestampFormat:"unix"`

	// The name of the vocabulary that was updated.
	VocabularyName *string `min:"1" type:"string"`

	// The processing state of the vocabulary. When the VocabularyState field contains
	// READY the vocabulary is ready to be used in a StartTranscriptionJob request.
	VocabularyState *string `type:"string" enum:"VocabularyState"`
	// contains filtered or unexported fields
}

func (UpdateVocabularyOutput) GoString added in v1.13.28

func (s UpdateVocabularyOutput) GoString() string

GoString returns the string representation

func (*UpdateVocabularyOutput) SetLanguageCode added in v1.13.28

func (s *UpdateVocabularyOutput) SetLanguageCode(v string) *UpdateVocabularyOutput

SetLanguageCode sets the LanguageCode field's value.

func (*UpdateVocabularyOutput) SetLastModifiedTime added in v1.13.28

func (s *UpdateVocabularyOutput) SetLastModifiedTime(v time.Time) *UpdateVocabularyOutput

SetLastModifiedTime sets the LastModifiedTime field's value.

func (*UpdateVocabularyOutput) SetVocabularyName added in v1.13.28

func (s *UpdateVocabularyOutput) SetVocabularyName(v string) *UpdateVocabularyOutput

SetVocabularyName sets the VocabularyName field's value.

func (*UpdateVocabularyOutput) SetVocabularyState added in v1.13.28

func (s *UpdateVocabularyOutput) SetVocabularyState(v string) *UpdateVocabularyOutput

SetVocabularyState sets the VocabularyState field's value.

func (UpdateVocabularyOutput) String added in v1.13.28

func (s UpdateVocabularyOutput) String() string

String returns the string representation

type VocabularyInfo added in v1.13.28

type VocabularyInfo struct {

	// The language code of the vocabulary entries.
	LanguageCode *string `type:"string" enum:"LanguageCode"`

	// The date and time that the vocabulary was last modified.
	LastModifiedTime *time.Time `type:"timestamp" timestampFormat:"unix"`

	// The name of the vocabulary.
	VocabularyName *string `min:"1" type:"string"`

	// The processing state of the vocabulary. If the state is READY you can use
	// the vocabulary in a StartTranscriptionJob request.
	VocabularyState *string `type:"string" enum:"VocabularyState"`
	// contains filtered or unexported fields
}

Provides information about a custom vocabulary.

func (VocabularyInfo) GoString added in v1.13.28

func (s VocabularyInfo) GoString() string

GoString returns the string representation

func (*VocabularyInfo) SetLanguageCode added in v1.13.28

func (s *VocabularyInfo) SetLanguageCode(v string) *VocabularyInfo

SetLanguageCode sets the LanguageCode field's value.

func (*VocabularyInfo) SetLastModifiedTime added in v1.13.28

func (s *VocabularyInfo) SetLastModifiedTime(v time.Time) *VocabularyInfo

SetLastModifiedTime sets the LastModifiedTime field's value.

func (*VocabularyInfo) SetVocabularyName added in v1.13.28

func (s *VocabularyInfo) SetVocabularyName(v string) *VocabularyInfo

SetVocabularyName sets the VocabularyName field's value.

func (*VocabularyInfo) SetVocabularyState added in v1.13.28

func (s *VocabularyInfo) SetVocabularyState(v string) *VocabularyInfo

SetVocabularyState sets the VocabularyState field's value.

func (VocabularyInfo) String added in v1.13.28

func (s VocabularyInfo) String() string

String returns the string representation

Directories

Path Synopsis
Package transcribeserviceiface provides an interface to enable mocking the Amazon Transcribe Service service client for testing your code.
Package transcribeserviceiface provides an interface to enable mocking the Amazon Transcribe Service service client for testing your code.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL