本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
ListTranscriptionJobs
提供符合指定準則的轉錄任務。如果未指定準則,則會傳回所有轉錄任務。
若要取得有關特定轉錄工作的詳細資訊,請使用此GetTranscriptionJob作業。
請求語法
{
"JobNameContains": "string
",
"MaxResults": number
,
"NextToken": "string
",
"Status": "string
"
}
請求參數
如需所有動作共用參數的相關資訊,請參閱一般參數。
請求接受採用 JSON 格式的下列資料。
- JobNameContains
-
僅傳回包含指定字串的轉錄工作。搜尋不區分大小寫。
類型:String
長度限制:長度下限為 1。長度上限為 200。
模式:
^[0-9a-zA-Z._-]+
必要:否
- MaxResults
-
在每一頁結果中傳回的轉錄工作數目上限。如果結果少於您指定的值,則只會傳回實際結果。如果您未指定值,則會使用預設值 5。
類型:整數
有效範圍:最小值為 1。最大值為 100。
必要:否
- NextToken
-
如果您的
ListTranscriptionJobs
要求傳回的結果多於可顯示的結果,NextToken
則會在回應中以相關聯的字串顯示。要獲取結果的下一頁,請複製此字符串並重複您的請求,NextToken
包括複製的字符串的值。視需要重複此步驟以檢視所有結果。類型:String
。
模式:
.+
必要:否
- Status
-
僅傳回處於指定狀態的轉錄任務。工作會依建立日期排序,最新的工作優先。如果未包含
Status
,則會傳回所有轉錄工作。類型:String
有效值:
QUEUED | IN_PROGRESS | FAILED | COMPLETED
必要:否
回應語法
{
"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"
}
]
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- NextToken
-
如
NextToken
果您的回應中存在,則表示並非顯示所有結果。若要檢視下一組結果,請在結果輸出中複製與NextToken
參數相關聯的字串,然後再次執行要求,包括NextToken
複製字串的值。視需要重複此步驟以檢視所有結果。類型:String
。
模式:
.+
- Status
-
列出在請求中指定狀態的所有轉錄工作。工作會依建立日期排序,最新的工作優先。
類型:String
有效值:
QUEUED | IN_PROGRESS | FAILED | COMPLETED
- TranscriptionJobSummaries
-
提供有關每個結果的資訊摘要。
類型:TranscriptionJobSummary 物件陣列
錯誤
如需所有動作常見的錯誤相關資訊,請參閱常見錯誤。
- BadRequestException
-
您的要求未通過一或多個驗證測試。當您嘗試刪除的實體不存在或處於非終端狀態(例如
IN PROGRESS
)時,可能會發生這種情況。如需詳細資訊,請參閱例外訊息欄位。HTTP 狀態碼:400
- InternalFailureException
-
發生內部錯誤。檢查錯誤訊息,更正問題,然後再次嘗試您的請求。
HTTP 狀態碼:500
- LimitExceededException
-
您可能傳送太多要求,或輸入檔案太長。請先等候再重試要求,或使用較小的檔案再試一次。
HTTP 狀態碼:400
另請參閱
如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: