翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# での Amazon EventBridge の使用Amazon Transcribe
Amazon EventBridge を使用すると、他の AWS のサービス でイベントを開始させることで Amazon Transcribe ジョブの状態の変化に対応できます。書き起こしジョブの状態が変わると、EventBridge は自動的にイベントをイベントストリームに送信します。イベントストリーム内でモニタリングするイベントと、それらのイベントが発生したときに EventBridge によって実行されるアクションを定義するルールを作成します。例えば、イベントを別のサービス (ターゲット) にルーティングし、そこからアクションが実行されるようにできます。この場合、文字起こしジョブが正常に完了したときにイベントを AWS Lambda 関数にルーティングするように、ルールを設定できます。[EventBridge ルール](#defining-rules)を定義するには、以下のセクションを参照してください。
イベントの通知は、Eメール、[チャットアプリケーション内の Amazon Q Developer](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html)のチャット通知、[AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html)のプッシュ通知などの複数のチャネルで受け取ることができます。「[コンソール通知センター](https://console.aws.amazon.com/notifications/)」で通知を確認することもできます。通知を設定する場合は、[AWS User Notifications](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html) を使用できます。AWS User Notifications は、集約をサポートしているため、特定のイベント中に受け取る通知の数を減らすことができます。
## EventBridge ルールの定義
EventBridge ルールを定義するには、 [AWS マネジメントコンソール](https://console.aws.amazon.com/events) を使用します。ルールを定義するときは、サービス名として Amazon Transcribe を使用します。EventBridge ルールの作成方法の例については、「[Amazon EventBridge ルール](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)」を参照してください。
EventBridge を使用する前に、次の定義に注意してください。
+ **イベント** - イベントは、文字起こしジョブのいずれかの状態の変化を示します。例えば、ジョブの `TranscriptionJobStatus` が `IN_PROGRESS` から `COMPLETED` に変わります。
+ **ターゲット** - ターゲットは、イベントを処理する別の AWS のサービス です。たとえば、AWS Lambda や Amazon Simple Notification Service (Amazon SNS) です。ターゲットは、JSON 形式のイベントを受け取ります。
+ **ルール** - ルールに一致するイベントは EventBridge のモニタリング対象であり、処理のために 1 つまたは複数のターゲットにルーティングされます。ルールによってイベントが複数のターゲットにルーティングされた場合、すべてのターゲットではそのイベントが並行して処理されます。ルールでは、ターゲットに送信される JSON をカスタマイズできます。
Amazon EventBridge イベントは、ベストエフォートベースで出力されます。EventBridge でのイベントの作成と管理について詳しくは、*Amazon EventBridge ユーザーガイド*の「[Amazon EventBridge イベント](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)」を参照してください。
以下は、文字起こしジョブのステータスが `COMPLETED` または `FAILED` に変わったときに開始される、Amazon Transcribe の EventBridge ルールの例です。
```
{
"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` に変わったときにイベントが開始されます。
## Amazon Transcribe のイベント
Amazon EventBridge は複数の Amazon Transcribe イベントを記録します。
+ [文字起こしジョブイベント](#job-event)
+ [言語識別イベント](#lang-id-event)
+ [コール分析イベント](#analytics-event)
+ [コール分析通話後のイベント](#analytics-stream-event)
+ [語彙イベント](#vocab-event)
これらのイベントにはすべて、以下の共有フィールドが含まれます。
+ `version`: イベントデータのバージョン。この値は常に `0` です。
+ `id`: イベントに対して EventBridge によって生成された固有 ID。
+ `detail-type`: イベントの詳細の識別子。例えば、`Transcribe Job State Change`。
+ `source`: イベントのソース。Amazon Transcribe の場合、これは常に `aws.transcribe` です。
+ `account`: API コールを生成したアカウントの AWS アカウント ID。
+ `time`: イベントが配信された日時。
+ `region`: リクエストが行われたAWS リージョン。
+ `resources`: API コールによって使用されたリソース。Amazon Transcribe の場合、このフィールドは常に空です。
+ `detail`: イベントに関するその他の詳細
+ `FailureReason`: このフィールドは、状態またはステータスが `FAILED` に変化した場合に表示され、`FAILED` の状態またはステータスになった理由が説明されます。
+ 各イベントタイプには、`detail` の下に表示される追加の固有のフィールドがあります。これらの固有のフィールドは、各イベント例の後に続く以下のセクションで定義されています。
### 文字起こしジョブイベント
ジョブの状態が `IN_PROGRESS` から `COMPLETED` または `FAILED` に変化すると、Amazon Transcribe はイベントを生成します。ターゲットの状態を変更してイベントを開始させたジョブを特定するには、イベントの `TranscriptionJobName` フィールドを使用します。Amazon Transcribe イベントには、以下の情報が含まれています。文字起こしジョブのステータスが `FAILED` の場合、`detail` の下に `FailureReason` フィールドが追加されます。
このイベントは [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) API オペレーションにのみ適用されることに注意してください。
```
{
"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" (or "FAILED")
}
}
```
+ `TranscriptionJobName`: 文字起こしジョブに選択した固有の名前。
+ `TranscriptionJobStatus `: 文字起こしのジョブのステータス。これは、`COMPLETED` または `FAILED` です。
### 言語識別イベント
[自動言語識別](lang-id.md)を有効にすると、Amazon Transcribe は、言語識別の状態が `COMPLETED` または `FAILED` の場合にイベントを生成します。ターゲットの状態を変更してイベントを開始させたジョブを特定するには、イベントの `JobName` フィールドを使用します。Amazon Transcribe イベントには、以下の情報が含まれています。言語識別ステータスが `FAILED` の場合、`detail` の下に `FailureReason` フィールドが追加されます。
このイベントは、[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_LanguageIdSettings.html) パラメータが含まれている場合の [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) API オペレーションにのみ適用されることに注意してください。
```
{
"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": "my-first-lang-id-job",
"LanguageIdentificationStatus": "COMPLETED" (or "FAILED")
}
}
```
+ `JobType`: 文字起こしジョブの場合、この値は `TranscriptionJob` でなければなりません。
+ `JobName`: 文字起こしジョブの固有の名前。
+ `LanguageIdentificationStatus`: 文字起こしジョブにおける言語識別のステータス。これは、`COMPLETED` または `FAILED` です。
### コール分析イベント
[コール分析](call-analytics.md)ジョブの状態が `IN_PROGRESS` から `COMPLETED` または `FAILED` に変化すると、Amazon Transcribe はイベントを生成します。ターゲットで状態を変更してイベントを開始させたコール分析ジョブを特定するには、イベントの `JobName` フィールドを使用します。Amazon Transcribe イベントには、以下の情報が含まれています。コール分析ジョブのステータスが `FAILED` の場合、`detail` の下に `FailureReason` フィールドが追加されます。
このイベントは [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html) API オペレーションにのみ適用されることに注意してください。
```
{
"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": "my-first-analytics-job",
"JobStatus": "COMPLETED" (or "FAILED"),
"FailureReason": "failure reason", // only present when JobStatus is FAILED
"AnalyticsJobDetails": { // only when you enable optional features such as Generative Call Summarization
"Skipped": []
}
}
}
```
+ `JobName`: コール分析文字起こしジョブの固有の名前。
+ `JobStatus`: コール分析文字起こしジョブのステータス。`COMPLETED` または `FAILED` のいずれかとなります。
+ `FailureReason`: このフィールドは `JobStatus` が `FAILED` の場合にのみ存在し、失敗の理由を示します。
+ `AnalyticsJobDetails`: スキップされた分析機能に関する情報を含む、コール分析文字起こしジョブの詳細。
### コール分析通話後のイベント
[通話後分析](tca-post-call.md)文字起こしが `IN_PROGRESS` から `COMPLETED` または `FAILED` の状態に変化すると、Amazon Transcribe はイベントを生成します。ターゲットで状態を変更してイベントを開始させたコール分析通話後ジョブを特定するには、イベントの `StreamingSessionId` フィールドを使用します。
このイベントは、[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_PostCallAnalyticsSettings.html) パラメータが含まれている場合の [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartCallAnalyticsStreamTranscription.html) API オペレーションにのみ適用されることに注意してください。
`COMPLETED` イベントには、以下の情報が含まれています。
```
{
"version": "0",
"id": "event ID",
"detail-type": "Call Analytics Post Call Job State Change",
"source": "aws.transcribe",
"account": "111122223333",
"time": "timestamp",
"region": "us-west-2",
"resources": [],
"detail": {
"StreamingSessionId": "session-id",
"PostCallStatus": "COMPLETED",
"Transcript": {
"RedactedTranscriptFileUri": "s3://amzn-s3-demo-bucket/my-output-files/my-redacted-file.JSON",
"TranscriptFileUri": "s3://amzn-s3-demo-bucket/my-output-files/my-file.JSON"
},
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-output-files/my-redacted-file.WAV",
"RedactedMediaFileUri": "s3://amzn-s3-demo-bucket/my-output-files/my-redacted-file.WAV"
}
}
}
```
`FAILED` イベントには、以下の情報が含まれています。
```
{
"version": "0",
"id": "event ID",
"detail-type": "Call Analytics Post Call Job State Change",
"source": "aws.transcribe",
"account": "111122223333",
"time": "timestamp",
"region": "us-west-2",
"resources": [],
"detail": {
"StreamingSessionId": "session-id",
"PostCallStatus": "FAILED"
}
}
```
+ `StreamingSessionId`: リアルタイムコール分析文字起こしリクエストに割り当てられる識別番号。
+ `PostCallStatus`: 通話後コール分析文字起こしジョブのステータス。`COMPLETED` または `FAILED` のいずれかとなります。
+ `Transcript`: 編集済みおよび未編集のトランスクリプトの URI。
+ `Media`: 編集済みおよび未編集の音声ファイルの URI。
### AWS HealthScribe ストリーム後分析イベント
[ClinicalNoteGenerationResult](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_ClinicalNoteGenerationResult.html) が `IN_PROGRESS` から `COMPLETED` に変わるなど、AWS HealthScribe ストリーム後分析オペレーションの状態が変わると、AWS HealthScribe は次の情報を含むイベントを生成します。
```
{
"version":"0",
"id":"event ID",
"detail-type":"MedicalScribe Post Stream Analytics Update",
"source":"aws.transcribe",
"account":"111122223333",
"time":"timestamp",
"region":"us-east-1",
"resources":[],
"detail":{
"SessionId": ,
"UpdateType": "ClinicalNoteGenerationResult",
"ClinicalNoteGenerationResult": {
"ClinicalNoteOutputLocation": s3://amzn-s3-demo-bucket/clinical-note-output-files/clinical-notes.JSON,
"TranscriptOutputLocation": s3://amzn-s3-demo-bucket/my-output-files/my-file.JSON,
"Status": ,
"FailureReason":
}
}
}
```
+ `UpdateType`: イベントを生成したストリーム後分析オペレーションのタイプ。結果オブジェクトの内容は、`UpdateType` によって異なります。
+ `SessionId`: AWS HealthScribe ストリームの識別番号。この ID を使用して、元のストリーミングセッションを識別し、イベントを生成したストリーム後分析を検索します。
+ `Status`: ストリーム後分析オペレーションのステータス。これは、`IN_PROGRESS`、`COMPLETED`、または `FAILED` です。
+ `ClinicalNoteOutputLocation`: `ClinicalNoteGenerationResult` の出力 Amazon S3 バケットの URI。
+ `TranscriptOutputLocation`: トランスクリプトの URI。
### 語彙イベント
[カスタム語彙](custom-vocabulary.md)の状態が `PENDING` から `READY` または `FAILED` に変化すると、Amazon Transcribe はイベントを生成します。ターゲットの状態を変更してイベントを開始させたカスタム語彙を特定するには、イベントの `VocabularyName` フィールドを使用します。Amazon Transcribe イベントには、以下の情報が含まれています。カスタム語彙の状態が `FAILED` の場合、`detail` の下に `FailureReason` フィールドが追加されます。
**注記**
このイベントは [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html) API オペレーションにのみ適用されます。
```
{
"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": "READY" (or "FAILED")
}
}
```
+ `VocabularyName`: カスタム語彙の固有の名前です。
+ `VocabularyState`: カスタム語彙の処理状態。これは、`READY` または `FAILED` です。