使用 AmazonEventBridge和Amazon Transcribe - Amazon Transcribe
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用 AmazonEventBridge和Amazon Transcribe

使用 AmazonEventBridge,您可以响应您的状态更改Amazon Transcribe通过在其他中触发事件Amazon Web Services服务。当转录作业更改状态时,EventBridge 会自动将事件发送到事件流。您可以创建规则来定义希望在事件流中监控的事件以及在这些事件发生时 EventBridge 应采取的操作。例如,将事件路由到其他服务(或目标),然后再采取操作。例如,您可以将规则配置为在成功完成转录作业时将事件路由到 Amazon Lambda 函数。

在使用 EventBridge 之前,您应了解以下概念:

  • Event事件指示某个转录作业的状态发生更改。例如,当任务的 TranscriptionJobStatusIN_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. 在定义规则时,将 Amazon Transcribe 用作服务名称。有关如何创建一个示例EventBridge规则,请参阅亚马逊EventBridge规则.

以下是一个示例。EventBridge规则Amazon Transcribe. 此规则在转录作业的状态更改为 COMPLETEDFAILED 时触发。

{ "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转录作业的新作业状态。在此示例中,规则将在作业状态更改为 COMPLETEDFAILED 时触发事件。有关状态值的列表,请参阅TranscriptionJobStatus的字段TranscriptionJobAPI。

Amazon Transcribe 事件

亚马逊EventBridge记录三种Amazon Transcribe事件:转录工作事件、自动语言识别事件和呼叫 Analytics 事件。

事件示例下面提供了所有字段的定义。

转录工作事件

当任务的状态从 IN_PROGRESS 更改为 COMPLETEDFAILED 时,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 ChangeLanguage Identification State ChangeCall 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-有关事件的详细信息。中的字段detailtag 可能因事件类型而异,但可能包含以下字段:

    • JobType— 对于转录作业,此值必须为TranscriptionJob.

    • JobName-转录作业的唯一名称。

    • JobStatus— 呼叫分析转录作业的状态。它可以是COMPLETED要么FAILED.

    • TranscriptionJobName— 你为转录工作选择的唯一名称。

    • TranscriptionJobStatus 转录作业的状态。有关状态值的列表,请参阅 TranscriptionJob 数据类型的 TranscriptionJobStatus 字段。

    • LanguageIdentificationStatus— 转录作业中语言识别的状态。它可以是COMPLETED要么FAILED.

    • VocabularyName-词汇表的唯一名称。

    • VocabularyState— 你的词汇量的处理状态。有关状态值的列表,请参阅 VocabularyInfo 数据类型的 VocabularyState 字段。

    • FailureReason— 如果状态或状态更改为,则存在此字段FAILED,并描述了出现FAILED状态或状态。