기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon EventBridge 와 함께 사용 Amazon Transcribe

를 사용하면 다른 작업에서 이벤트를 시작하여 Amazon Transcribe 작업의 상태 변화에 대응할 수 있습니다. Amazon EventBridge AWS 서비스트랜스크립션 작업의 상태가 변경되면 EventBridge 자동으로 이벤트를 이벤트 스트림으로 보냅니다. 이벤트 스트림에서 모니터링하고자 하는 이벤트를 정의하고, 이벤트 발생 시 EventBridge 에서 취해야 할 조치를 정의하는 규칙을 생성합니다. 조치를 취할 수 있는 또 다른 서비스(또는 대상)로 이벤트를 라우팅하는 경우를 예로 들 수 있습니다. 예를 들어, 트랜스크립션 작업이 성공적으로 완료되었을 때 이벤트를 AWS Lambda 함수로 라우팅하도록 규칙을 구성할 수 있습니다. EventBridge 규칙을 정의하려면 다음 섹션을 참조하세요.

이메일, AWS Chatbot 채팅 알림 또는 AWS Console Mobile Application 푸시 알림을 비롯한 여러 채널을 통해 이벤트에 대한 알림을 받을 수 있습니다. 콘솔 알림 센터에서도 알림을 볼 수 있습니다. 알림을 설정하려는 경우 사용할 AWS 사용자 알림수 있습니다. AWS 사용자 알림 집계를 지원하므로 특정 이벤트 중에 받는 알림 수를 줄일 수 있습니다.

규칙 정의 EventBridge

EventBridge 규칙을 정의하려면 를 사용하십시오 AWS Management Console. 규칙을 정의할 때 Amazon Transcribe 를 서비스 이름으로 사용하세요. 규칙을 만드는 방법에 대한 예는 Amazon EventBridge 규칙을 참조하십시오. EventBridge

사용하기 EventBridge전에 다음 정의를 참고하십시오.

Amazon EventBridge 이벤트는 최선의 노력을 기울여 발생합니다. 에서 EventBridge이벤트를 만들고 관리하는 방법에 대한 자세한 내용은 Amazon EventBridge 사용 설명서의Amazon EventBridge 이벤트를 참조하십시오.

다음은 트랜스크립션 작업의 상태가 또는 로 COMPLETED 변경될 때 시작되는 EventBridge 규칙의 예입니다. Amazon Transcribe FAILED

{
    "source": [
        "aws.transcribe"
    ],
    "detail-type": [
        "Transcribe Job State Change"
    ],
    "detail": {
        "TranscriptionJobStatus": [
            "COMPLETED",
            "FAILED"
        ]
    }
}

규칙에는 다음 필드가 포함됩니다.

Amazon Transcribe 이벤트

Amazon EventBridge 여러 Amazon Transcribe 이벤트를 기록합니다.

이러한 이벤트는 모두 다음과 같은 공유 필드를 포함합니다.

트랜스크립션 작업 이벤트

작업 상태가 에서 COMPLETED 또는 IN_PROGRESS FAILED 로 변경되면 이벤트가 Amazon Transcribe 생성됩니다. 상태가 바뀐 작업을 식별하고 대상에서 이벤트를 시작하려면 이벤트의 TranscriptionJobName 필드를 사용합니다. Amazon Transcribe 이벤트에는 다음 정보가 포함됩니다. 트랜스크립션 작업 상태가 detail인 경우 FailureReason 필드가 FAILED 아래에 추가됩니다.

단, 이 이벤트는 StartTranscriptionJob 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")
    }   
}

언어 식별 이벤트

자동 언어 식별을 활성화하면 언어 식별 상태가 COMPLETED 또는 FAILED일 때 Amazon Transcribe 에서 이벤트를 생성합니다. 상태가 바뀐 작업을 식별하고 대상에서 이벤트를 시작하려면 이벤트의 JobName 필드를 사용합니다. Amazon Transcribe 이벤트에는 다음 정보가 포함됩니다. 언어 식별 상태가 FAILED인 경우 FailureReason 필드가 detail 아래에 추가됩니다.

단, 이 이벤트는 LanguageIdSettings 파라미터가 포함된 경우 StartTranscriptionJob 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")
    }
}

Call Analytics 이벤트

Call Analytics 작업의 상태가 IN_PROGRESS에서 COMPLETED 또는 FAILED로 바뀌면 Amazon Transcribe 에서 이벤트를 생성합니다. 상태가 바뀐 Call Analytics 작업을 식별하고 대상에서 이벤트를 시작하려면 이벤트의 JobName 필드를 사용합니다. Amazon Transcribe 이벤트에는 다음 정보가 포함됩니다. Call Analytics 작업의 상태가 FAILED인 경우 FailureReason 필드가 detail 아래에 추가됩니다.

단, 이 이벤트는 StartCallAnalyticsJob 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"),
        "AnalyticsJobDetails": { // only when you enable optional features such as Generative Call Summarization
            "Skipped": []
        }
    }
}

Call Analytics 통화 후 이벤트

통화 후 분석 트랜스크립션의 상태가 IN_PROGRESS에서 COMPLETED 또는 FAILED로 바뀌면 Amazon Transcribe 에서 이벤트를 생성합니다. 상태가 바뀐 Call Analytics 통화 후 작업을 식별하고 대상에서 이벤트를 시작하려면 이벤트의 StreamingSessionId 필드를 사용합니다.

단, 이 이벤트는 PostCallAnalyticsSettings 파라미터가 포함된 경우 StartCallAnalyticsStreamTranscription 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://DOC-EXAMPLE-BUCKET/my-output-files/my-redacted-file.JSON",
            "TranscriptFileUri": "s3://DOC-EXAMPLE-BUCKET/my-output-files/my-file.JSON"
        },
        "Media": {
            "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/my-output-files/my-redacted-file.WAV",
            "RedactedMediaFileUri": "s3://DOC-EXAMPLE-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"
    }
}

어휘 이벤트

사용자 지정 어휘의 상태가 에서 READY 또는 PENDING 로 변경되면 FAILED 이벤트가 Amazon Transcribe 생성됩니다. 상태가 바뀐 사용자 지정 어휘를 식별하고 대상에서 이벤트를 시작하려면 이벤트의 VocabularyName 필드를 사용합니다. Amazon Transcribe 이벤트에는 다음 정보가 포함됩니다. 사용자 지정 어휘 상태가 FAILED인 경우 FailureReason 필드가 detail 아래에 추가됩니다.

단, 이 이벤트는 CreateVocabulary 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")
    }
}