Regeln definieren EventBridge Amazon Transcribe Ereignisse

Verwenden Amazon EventBridge mit Amazon Transcribe

Mit Amazon EventBridge können Sie auf Statusänderungen in Ihren Amazon Transcribe Jobs reagieren, indem Sie Ereignisse in anderen Bereichen einleiten. AWS-Services Wenn sich der Status eines Transkriptionsauftrags ändert, EventBridge wird automatisch ein Ereignis an einen Event-Stream gesendet. Sie erstellen Regeln, die die Ereignisse, die Sie im Ereignis-Stream überwachen möchten, sowie die Aktion definieren, die EventBridge im Falle solcher Ereignisse ausführen soll. Beispiel: Das Ereignis an einen anderen Service (oder ein anderes Ziel) weiterleiten, der/das dann eine Aktion ausführen kann. Sie könnten beispielsweise eine Regel so konfigurieren, dass ein Ereignis an eine AWS Lambda Funktion weitergeleitet wird, wenn ein Transkriptionsauftrag erfolgreich abgeschlossen wurde. Informationen zum Definieren von EventBridge -Regeln finden Sie in den folgenden Abschnitten.

Sie können Benachrichtigungen für Ereignisse über mehrere Kanäle erhalten, einschließlich E-Mail-, AWS Chatbot-Chat- oder AWS Console Mobile Application-Push-Benachrichtigungen. Benachrichtigungen werden auch im Console Notifications Center angezeigt. Wenn Sie Benachrichtigungen einrichten möchten, können Sie verwenden AWS-Benutzerbenachrichtigungen. AWS-Benutzerbenachrichtigungen unterstützt die Aggregation, wodurch die Anzahl der Benachrichtigungen, die Sie bei bestimmten Ereignissen erhalten, reduziert werden kann.

Regeln definieren EventBridge

Um EventBridge Regeln zu definieren, verwenden Sie den AWS Management Console. Wenn Sie eine Regel definieren, verwenden Sie Amazon Transcribe als Servicenamen. Ein Beispiel für die Erstellung einer EventBridge Regel finden Sie unter Amazon EventBridge Regeln.

Beachten Sie EventBridge vor der Verwendung die folgenden Definitionen:

Ereignis – Ein Ereignis zeigt an, dass sich der Zustand eines Ihrer Transkriptionsaufträge geändert hat. Zum Beispiel wenn sich der TranscriptionJobStatus eines Auftrags von IN_PROGRESS in COMPLETED ändert.
Ziel – Ein Ziel ist ein anderes AWS-Service , das ein Ereignis verarbeitet. Zum Beispiel AWS Lambda oder Amazon Simple Notification Service (Amazon SNS). Ein Ziel empfängt Ereignisse im JSON-Format.
Regel — Eine Regel sucht nach eingehenden Ereignissen, EventBridge nach denen Sie Ausschau halten möchten, und leitet sie zur Verarbeitung an ein oder mehrere Ziele weiter. Wenn eine Regel ein Ereignis an mehrere Ziele weiterleitet, verarbeiten alle Ziele das Ereignis parallel. Eine Regel kann die an das Ziel gesendete JSON-Datei anpassen.

Amazon EventBridge Ereignisse werden nach bestem Wissen und Gewissen ausgegeben. Weitere Informationen zum Erstellen und Verwalten von Ereignissen in EventBridge finden Sie unter Amazon EventBridge Ereignisse im Amazon EventBridge Benutzerhandbuch.

Im Folgenden finden Sie ein Beispiel für eine EventBridge Regel Amazon Transcribe , die ausgelöst wird, wenn sich der Status eines Transkriptionsauftrags auf COMPLETED oder FAILED ändert.


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

Die Regel enthält die folgenden Felder:

source – Die Quelle des Ereignisses. Denn Amazon Transcribe das ist immer aws.transcribe so.
detail-type – Ein Bezeichner für die Details des Ereignisses. Für Amazon Transcribe ist dies immer Transcribe Job State Change.
detail – Der neue Auftragsstatus des Transkriptionsauftrags. In diesem Beispiel löst die Regel ein Ereignis aus, wenn sich der Auftragsstatus zu COMPLETED oder FAILEDändert.

Amazon Transcribe Ereignisse

Amazon EventBridge protokolliert mehrere Amazon Transcribe Ereignisse:

Ereignisse in Transkriptionsaufträgen
Sprachenidentifikationsereignisse
Call-Analytics-Ereignisse aufrufen
Call-Analytics-nach-Anfruf-Ereignissen aufrufen
Ereignisse im Wortschatz

Diese Ereignisse enthalten alle die folgenden gemeinsamen Felder:

version: Die Version der Ereignisdaten. Dieser Wert ist immer 0.
id: Eine eindeutige Kennung, die von EventBridge für das Ereignis generiert wurde.
detail-type: Ein Bezeichner für die Details des Ereignisses. z. B. Transcribe Job State Change.
source: Die Quelle des Ereignisses. Denn Amazon Transcribe das ist immer soaws.transcribe.
account: Die AWS-Konto ID des Kontos, das den API-Aufruf generiert hat.
time: Das Datum und die Uhrzeit, zu der das Ereignis übertragen wird.
region: Die, AWS-Region in der die Anfrage gestellt wird.
resources: Die von dem API-Aufruf verwendeten Ressourcen. Für Amazon Transcribe, dieses Feld ist immer leer.
detail: Zusätzliche Details zum Ereignis.
- FailureReason: Dieses Feld ist vorhanden, wenn der Zustand oder der Status geändert wird zu FAILED, und beschreibt den Grund für den FAILED-Zustand oder -Status.
- Jeder Ereignistyp hat zusätzliche eindeutige Felder, die unter detail angezeigt werden. Diese eindeutigen Felder werden in den folgenden Abschnitten nach jedem Ereignisbeispiel definiert.

Ereignisse in Transkriptionsaufträgen

Wenn sich der Status eines Jobs von IN_PROGRESS zu COMPLETED oder ändertFAILED, Amazon Transcribe wird ein Ereignis generiert. Um den Job zu identifizieren, der den Zustand geändert und das Ereignis in Ihrem Ziel ausgelöst hat, verwenden Sie das Feld TranscriptionJobName des Ereignisses. Ein Amazon Transcribe Ereignis enthält die folgenden Informationen. Ein FailureReason-Feld wird unter detail hinzugefügt, wenn Ihr Transkriptionsjobstatus FAILED lautet.

Beachten Sie, dass dieses Ereignis nur für den StartTranscriptionJob-API-Vorgang gilt.


{
    "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: Der eindeutige Name, den Sie für Ihren Transkriptionsauftrag gewählt haben.
TranscriptionJobStatus : Der Status des Transkriptionsauftrags. Mögliche Werte sind COMPLETED oder FAILED.

Sprachenidentifikationsereignisse

Wenn Sie die automatische Sprachenidentifikation aktivieren, generiert Amazon Transcribe ein Ereignis, wenn der Zustand der Sprachidentifikation COMPLETED oder lautetFAILED. Um den Job zu identifizieren, der den Zustand geändert und das Ereignis in Ihrem Ziel ausgelöst hat, verwenden Sie das Feld JobName des Ereignisses. Ein Amazon Transcribe -Ereignis enthält die folgenden Informationen: Ein FailureReason-Feld wird unter detail hinzugefügt, falls Ihre Sprachidentifikation den Status FAILED hat.

Beachten Sie, dass dieses Ereignis nur für den StartTranscriptionJob-API-Vorgang gilt, wenn der LanguageIdSettings-Parameter enthalten ist.


{
    "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: Für Transkriptionsaufträge muss dieser Wert TranscriptionJob sein.
JobName: Der eindeutige Name, den Sie für Ihren Transkriptionsauftrag gewählt haben.
LanguageIdentificationStatus: Der Status der Sprachidentifikation in einem Transkriptionsauftrag. Mögliche Werte sind COMPLETED oder FAILED.

Call-Analytics-Ereignisse aufrufen

Wenn der Zustand eines Call-Analytics-Auftrags von IN_PROGRESS zu COMPLETED oder FAILEDwechselt, erzeugt Amazon Transcribe ein Ereignis. Um den Call-Analytics-Auftrag zu identifizieren, der den Zustand geändert hat und das Ereignis in Ihrem Ziel auslöst, verwenden Sie das Feld JobName des Ereignisses. Ein Amazon Transcribe -Ereignis enthält die folgenden Informationen: Ein FailureReason-Feld wird unter detail hinzugefügt, wenn Ihr Call-Analytics-Auftragsstatus FAILED lautet.

Beachten Sie, dass dieses Ereignis nur für den StartCallAnalyticsJob-API-Vorgang gilt.


{
    "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": []
        }
    }
}

JobName: Der eindeutige Name Ihres Call-Analytics-Transkriptionsauftrags.
JobStatus: Der eindeutige Status Ihres Call-Analytics-Transkriptionsauftrags. Dies kann entweder COMPLETED oder FAILEDsein.
AnalyticsJobDetails: Die Details Ihres Call Analytics-Transkriptionsauftrags, einschließlich Informationen zu übersprungenen Analysefunktionen.

Call-Analytics-nach-Anfruf-Ereignissen aufrufen

Wenn eine nach-Anfruf-Analytics-Transkription den Zustand von IN_PROGRESS zu COMPLETED oder FAILED, Amazon Transcribe ändert, wird ein Ereignis erzeugt. Um den Call-Analytics-Auftrag nach dem Gespräch zu identifizieren, der den Zustand geändert und das Ereignis in Ihrem Ziel ausgelöst hat, verwenden Sie das Feld StreamingSessionId des Ereignisses.

Beachten Sie, dass dieses Ereignis nur für den StartCallAnalyticsStreamTranscription-API-Vorgang gilt, wenn der PostCallAnalyticsSettings-Parameter enthalten ist.

Ein COMPLETED-Ereignis enthält die folgenden Informationen:


{
    "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"
        }
    }
}

Ein FAILED-Ereignis enthält die folgenden Informationen:


{
    "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: Die Identifikationsnummer, die Ihrer Call-Analytics-Transkriptionsanfrage in Echtzeit zugewiesen wurde.
PostCallStatus: Der Status Ihrer Call-Analytics-Transkription nach Anrufen. Dies kann entweder COMPLETED oder FAILEDsein.
Transcript: Die URI Ihrer redigierten und unredigierten Transkripte.
Media: Die URI Ihrer redigierten und unredigierten Audiodateien.

Ereignisse im Wortschatz

Wenn der Status eines benutzerdefinierten Vokabulars von PENDING zu READY oder wechseltFAILED, Amazon Transcribe wird ein Ereignis generiert. Um das benutzerdefinierte Vokabular zu identifizieren, das den Zustand geändert und das Ereignis in Ihrem Ziel ausgelöst hat, verwenden Sie das Feld VocabularyName des Ereignisses. Ein Amazon Transcribe Ereignis enthält die folgenden Informationen. Ein FailureReason-Feld wird unter detail hinzugefügt, wenn Ihr benutzerdefinierter Wortschatzzustand FAILED lautet.

Beachten Sie, dass dieses Ereignis nur für den CreateVocabulary-API-Vorgang gilt.


{
    "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: Der eindeutige Name Ihres benutzerdefinierten Vokabulars.
VocabularyState: Der Verarbeitungszustand Ihres benutzerdefinierten Vokabulars. Mögliche Werte sind READY oder FAILED.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Überwachung Amazon Transcribe mit CloudTrail

Compliance-Validierung