ListTranscriptionJobs

Stellt eine Liste von Transkriptionsaufgaben bereit, die den angegebenen Kriterien entsprechen. Wenn keine Kriterien angegeben werden, werden alle Transkriptionsaufgaben zurückgegeben.

Verwenden Sie dieGetTranscriptionJob Operation, um detaillierte Informationen zu einem bestimmten Transkriptionsjob zu erhalten.

Anforderungssyntax

{
   "JobNameContains": "string",
   "MaxResults": number,
   "NextToken": "string",
   "Status": "string"
}

Anfrageparameter

Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

JobNameContains

Gibt nur die Transkriptionsaufträge zurück, die die angegebene Zeichenfolge enthalten. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 200 Zeichen.

Pattern: ^[0-9a-zA-Z._-]+

Required: No

MaxResults

Die maximale Anzahl von Transkriptionsaufträgen, die auf jeder Ergebnisseite zurückgegeben werden sollen. Wenn es weniger Ergebnisse als den von Ihnen angegebenen Wert gibt, werden nur die tatsächlichen Ergebnisse zurückgegeben. Wenn Sie keinen Wert angeben, wird der Standardwert 5 verwendet.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1. Maximalwert 100.

Required: No

NextToken

Wenn IhreListTranscriptionJobs Anfrage mehr Ergebnisse liefert, als angezeigt werden können,NextToken wird dies in der Antwort mit einer zugehörigen Zeichenfolge angezeigt. Um die nächste Ergebnisseite zu erhalten, kopieren Sie diese Zeichenfolge und wiederholen Sie Ihre Anfrage, auchNextToken mit dem Wert der kopierten Zeichenfolge. Wiederholen Sie den Vorgang nach Bedarf, um alle Ihre Ergebnisse zu sehen.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 8192.

Pattern: .+

Required: No

Status

Gibt nur Transkriptionsaufgaben mit dem angegebenen Status zurück. Jobs sind nach Erstellungsdatum sortiert, wobei der neueste Job an erster Stelle steht. Wenn Sie nicht angebenStatus, werden alle Transkriptionsaufträge zurückgegeben.

Typ: Zeichenfolge

Zulässige Werte: QUEUED | IN_PROGRESS | FAILED | COMPLETED

Erforderlich: Nein

Antwortsyntax

{
   "NextToken": "string",
   "Status": "string",
   "TranscriptionJobSummaries": [ 
      { 
         "CompletionTime": number,
         "ContentRedaction": { 
            "PiiEntityTypes": [ "string" ],
            "RedactionOutput": "string",
            "RedactionType": "string"
         },
         "CreationTime": number,
         "FailureReason": "string",
         "IdentifiedLanguageScore": number,
         "IdentifyLanguage": boolean,
         "IdentifyMultipleLanguages": boolean,
         "LanguageCode": "string",
         "LanguageCodes": [ 
            { 
               "DurationInSeconds": number,
               "LanguageCode": "string"
            }
         ],
         "ModelSettings": { 
            "LanguageModelName": "string"
         },
         "OutputLocationType": "string",
         "StartTime": number,
         "TranscriptionJobName": "string",
         "TranscriptionJobStatus": "string"
      }
   ]
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

NextToken

Wenn dies in Ihrer Antwort enthaltenNextToken ist, bedeutet dies, dass nicht alle Ergebnisse angezeigt werden. Um die nächsten Ergebnisse anzuzeigen, kopieren Sie die Zeichenfolge, die demNextToken Parameter in Ihrer Ergebnisausgabe zugeordnet ist, und führen Sie dann Ihre Anfrage erneut aus, einschließlichNextToken des Werts der kopierten Zeichenfolge. Wiederholen Sie den Vorgang nach Bedarf, um alle Ihre Ergebnisse zu sehen.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 8192.

Pattern: .+

Status

Listet alle Transkriptionsaufträge auf, die den in Ihrer Anfrage angegebenen Status haben. Jobs sind nach Erstellungsdatum sortiert, wobei der neueste Job an erster Stelle steht.

Typ: Zeichenfolge

Zulässige Werte: QUEUED | IN_PROGRESS | FAILED | COMPLETED

TranscriptionJobSummaries

Stellt eine Zusammenfassung der Informationen zu jedem Ergebnis bereit.

Typ: Array von TranscriptionJobSummary-Objekten

Fehler

Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehler.

BadRequestException

Ihre Anfrage hat einen oder mehrere Validierungstests nicht bestanden. Dies kann auftreten, wenn die Entität, die Sie zu löschen versuchen, nicht existiert oder wenn sie sich in einem Zustand befindet, der kein Terminal ist (z. B.IN PROGRESS). Weitere Informationen finden Sie im Feld für Ausnahmemeldungen.

HTTP Status Code: 400

InternalFailureException

Es ist ein interner Fehler aufgetreten. Überprüfen Sie die Fehlermeldung, korrigieren Sie das Problem und versuchen Sie es erneut mit Ihrer Anfrage.

HTTP Status Code: 500

LimitExceededException

Sie haben entweder zu viele Anfragen gesendet oder Ihre Eingabedatei ist zu lang. Warten Sie, bevor Sie Ihre Anfrage erneut versuchen, oder verwenden Sie eine kleinere Datei und versuchen Sie es erneut.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:

• AWS-Befehlszeilenschnittstelle

• AWS-SDK für .NET

• AWS-SDK für C++

• AWS-SDK for Go

• AWS-SDK für Java V2

• AWSSDK für JavaScript

• AWS SDK für PHP V3

• AWS SDK für Python

• AWS SDK für Ruby V3