本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用 AmazonEventBridge和Amazon Transcribe
使用 AmazonEventBridge,您可以响应您的状态更改Amazon Transcribe通过在其他中触发事件Amazon Web Services服务。当转录作业更改状态时,EventBridge 会自动将事件发送到事件流。您可以创建规则来定义希望在事件流中监控的事件以及在这些事件发生时 EventBridge 应采取的操作。例如,将事件路由到其他服务(或目标),然后再采取操作。例如,您可以将规则配置为在成功完成转录作业时将事件路由到 Amazon Lambda 函数。
在使用 EventBridge 之前,您应了解以下概念:
-
Event事件指示某个转录作业的状态发生更改。例如,当任务的
TranscriptionJobStatus
从IN_PROGRESS
更改为COMPLETED
时。 -
目标— 目标是另一个Amazon处理事件的服务。例如,Amazon Lambda或 Amazon Simple Notification Service (Amazon SNS)。目标接收 JSON 格式的事件。
-
Rule— 规则与您想要的传入事件匹配EventBridge以监视并将其路由到目标以进行处理。如果规则将一个事件路由到多个目标,则所有目标将并行处理该事件。规则可以自定义发送到目标的 JSON。
亚马逊EventBridge是在最大努力发出的。有关创建和管理事件的更多信息,请参阅EventBridge请参阅,亚马逊EventBridge事件中的亚马逊EventBridge用户指南.
定义EventBridge规则
要定义EventBridge规则,请使用Amazon Web Services Management Console
以下是一个示例。EventBridge规则Amazon Transcribe. 此规则在转录作业的状态更改为 COMPLETED
或 FAILED
时触发。
{ "source": [ "aws.transcribe" ], "detail-type": [ "Transcribe Job State Change" ], "detail": { "TranscriptionJobStatus": [ "COMPLETED", "FAILED" ] } }
规则包含以下字段:
-
source
事件的源。对于 Amazon Transcribe,这始终为aws.transcribe
。 -
detail-type
事件的详细信息的标识符。对于 Amazon Transcribe,这始终为Transcribe Job State Change
。 -
detail
转录作业的新作业状态。在此示例中,规则将在作业状态更改为COMPLETED
或FAILED
时触发事件。有关状态值的列表,请参阅TranscriptionJobStatus
的字段TranscriptionJobAPI。
Amazon Transcribe 事件
亚马逊EventBridge记录三种Amazon Transcribe事件:转录工作事件、自动语言识别事件和呼叫 Analytics 事件。
事件示例下面提供了所有字段的定义。
转录工作事件
当任务的状态从 IN_PROGRESS
更改为 COMPLETED
或 FAILED
时,Amazon Transcribe 会生成事件。要标识已更改状态并在您的目标中触发事件的作业,请使用事件的 TranscriptionJobName
字段。Amazon Transcribe 事件包含以下信息。一个FailureReason
字段被添加到detail
如果你的转录工作状态为FAILED
.
{ "version": "0", "id": "
event ID
", "detail-type":"Transcribe Job State Change", "source": "aws.transcribe", "account": "111122223333
", "time": "timestamp
", "region": "us-west-2
", "resources": [ ], "detail": { "TranscriptionJobName": "my-first-transcription-job
", "TranscriptionJobStatus": "COMPLETED
" } }
语言识别事件
启用自动语言识别时,Amazon Transcribe当语言识别状态为COMPLETED
要么FAILED
. 要标识已更改状态并在您的目标中触发事件的作业,请使用事件的 JobName
字段。Amazon Transcribe 事件包含以下信息。一个FailureReason
字段被添加到detail
如果你的语言识别状态为FAILED
.
{ "version": "0", "id": "
event ID
", "detail-type": "Language Identification State Change", "source": "aws.transcribe", "account": "111122223333
", "time": "timestamp
", "region": "us-west-2
", "resources": [ ], "detail": { "JobType": "TranscriptionJob", "JobName": "job-name
", "LanguageIdentificationStatus": "status
" } }
呼叫分析活动
当呼叫 Analytics 作业状态从IN_PROGRESS
或者COMPLETED
要么FAILED
、Amazon Transcribe生成一个事件。要标识已更改状态并在您的目标中触发事件的呼叫 Analytics 作业,请使用事件的JobName
字段中返回的子位置类型。Amazon Transcribe 事件包含以下信息。一个FailureReason
字段被添加到detail
如果你的呼叫分析工作状态为FAILED
.
{ "version": "0", "id": "
event ID
", "detail-type": "Call Analytics Job State Change", "source": "aws.transcribe", "account": "111122223333
", "time": "timestamp
", "region": "us-west-2
", "resources": [ ], "detail": { "JobName": "job-name
", "JobStatus": "status
" } }
词汇表事件
当词汇量的状态从PENDING
或者READY
要么FAILED
、Amazon Transcribe生成一个事件。要标识已更改状态并在您的目标中触发事件的词汇表,请使用事件的词汇表。VocabularyName
字段中返回的子位置类型。Amazon Transcribe 事件包含以下信息。一个FailureReason
字段被添加到detail
如果你的词汇状态是FAILED
.
{ "version": "0", "id": "
event ID
", "detail-type": "Vocabulary State Change", "source": "aws.transcribe", "account": "111122223333
", "time": "timestamp
", "region": "us-west-2
", "resources": [ ], "detail": { "VocabularyName": "unique-vocabulary-name
", "VocabularyState": "state
" } }
上述字段的说明:
-
version
事件数据的版本。此值始终为0
。 -
id
— 由生成的唯一标识符EventBridge对于事件。 -
detail-type
事件的详细信息的标识符。适用于Amazon Transcribe,这是其中之一Transcribe Job State Change
、Language Identification State Change
、Call Analytics Job State Change
,或者Vocabulary State Change
. -
source
事件的源。对于 Amazon Transcribe,这始终为aws.transcribe
。 -
account
— 该Amazon Web Services 账户生成了 API 调用的账户的 ID。 -
timestamp
— 事件的交付日期和时间。 -
region
— 该Amazon Web Services 区域进行 API 调用的位置。 -
resources
— API 调用使用的资源。对于 Amazon Transcribe,此字段始终为空。 -
detail
-有关事件的详细信息。中的字段detail
tag 可能因事件类型而异,但可能包含以下字段:-
JobType
— 对于转录作业,此值必须为TranscriptionJob
. -
JobName
-转录作业的唯一名称。 -
JobStatus
— 呼叫分析转录作业的状态。它可以是COMPLETED
要么FAILED
. -
TranscriptionJobName
— 你为转录工作选择的唯一名称。 -
TranscriptionJobStatus
转录作业的状态。有关状态值的列表,请参阅 TranscriptionJob 数据类型的TranscriptionJobStatus
字段。 -
LanguageIdentificationStatus
— 转录作业中语言识别的状态。它可以是COMPLETED
要么FAILED
. -
VocabularyName
-词汇表的唯一名称。 -
VocabularyState
— 你的词汇量的处理状态。有关状态值的列表,请参阅 VocabularyInfo 数据类型的VocabularyState
字段。 -
FailureReason
— 如果状态或状态更改为,则存在此字段FAILED
,并描述了出现FAILED
状态或状态。
-