Amazon Transcribe
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

将 Amazon CloudWatch Events 用于 Amazon Transcribe

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

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

  • 事件 – 事件指示某个转录作业的状态发生更改。例如,当任务的 TranscriptionJobStatusIN_PROGRESS 更改为 COMPLETED 时。

  • 目标 – 目标是其他处理事件的 AWS 服务。例如,AWS Lambda 或 Amazon Simple Notification Service (Amazon SNS)。目标接收 JSON 格式的事件。

  • 规则 – 规则与您希望 CloudWatch Events 监视的传入事件匹配并将这些事件路由到目标以进行处理。如果规则将一个事件路由到多个目标,则所有目标将并行处理该事件。规则可以自定义发送到目标的 JSON。

有关创建和管理 CloudWatch Events 事件的更多信息,请参阅 Amazon CloudWatch 用户指南 中的什么是 Amazon CloudWatch Events

定义 CloudWatch Events 规则

要定义 CloudWatch Events 规则,请使用 CloudWatch Events 控制台。在定义规则时,将 Amazon Transcribe 用作服务名称。有关如何创建 CloudWatch Events 规则的示例,请参阅 Amazon CloudWatch 用户指南 中的创建在事件上触发的 CloudWatch Events 规则

以下是 Amazon Transcribe 的 CloudWatch Events 规则的示例。此规则在转录作业的状态更改为 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 时触发事件。有关状态值的列表,请参阅 TranscriptionJob 数据类型的 TranscriptionJobStatus 字段。

Amazon Transcribe 事件

当任务的状态从 IN_PROGRESS 更改为 COMPLETEDFAILED 时,Amazon Transcribe 会生成事件。要标识已更改状态并在您的目标中触发事件的作业,请使用事件的 TranscriptionJobName 字段。Amazon Transcribe 事件包含以下信息。

{ "version": "0", "id": "event ID", "detail-type":"Transcribe Job State Change", "source": "aws.transcribe", "account": "account ID", "time": "timestamp", "region": "region", "resources": [], "detail": { "TranscriptionJobName": "unique job name", "TranscriptionJobStatus": "status" } }

传递到目标的事件包含以下信息:

  • version – 事件数据的版本。此值始终为 0

  • id – 由 CloudWatch Events 生成的事件的唯一标识符。

  • detail-type – 事件的详细信息的标识符。对于 Amazon Transcribe,这始终为 Transcribe Job State Change

  • source – 事件的源。对于 Amazon Transcribe,这始终为 Transcribe Job State Change

  • account ID – 生成了 API 调用的账户的 AWS 账户 ID。

  • timestamp – 进行 API 调用的日期和时间。

  • region – 进行 API 调用的 AWS 区域。

  • resources – API 调用使用的资源。对于 Amazon Transcribe,此字段始终为空。

  • detail – 有关事件的详细信息。它包含以下字段:

    • TranscriptionJobName – 您为作业提供的唯一名称。

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