本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# GetTranscriptionJob
<a name="API_GetTranscriptionJob"></a>

提供關於指定轉錄工作的資訊。

若要檢視指定的轉錄工作狀態，請勾選`TranscriptionJobStatus`欄位。如果狀態為`COMPLETED`，表示工作已完成。您可以在中指定的位置找到結果`TranscriptFileUri`。如果狀態為`FAILED`，則`FailureReason`提供轉錄工作失敗原因的詳細資訊。

如果您啟用內容密文，您可以在中指定的位置找到編輯的文字記錄`RedactedTranscriptFileUri`。

若要取得轉錄工作的清單，請使用此[ListTranscriptionJobs](API_ListTranscriptionJobs.md)作業。

## 請求語法
<a name="API_GetTranscriptionJob_RequestSyntax"></a>

```
{
   "TranscriptionJobName": "{{string}}"
}
```

## 請求參數
<a name="API_GetTranscriptionJob_RequestParameters"></a>

如需所有動作共用參數的相關資訊，請參閱一[般參數](CommonParameters.md)。

請求接受採用 JSON 格式的下列資料。

 ** [TranscriptionJobName](#API_GetTranscriptionJob_RequestSyntax) **   <a name="transcribe-GetTranscriptionJob-request-TranscriptionJobName"></a>
您想要相關資訊的轉錄工作名稱。Job 名稱會區分大小寫。  
類型：String  
長度限制：長度下限為 1。長度上限為 200。  
模式：`^[0-9a-zA-Z._-]+`  
必要：是

## 回應語法
<a name="API_GetTranscriptionJob_ResponseSyntax"></a>

```
{
   "TranscriptionJob": { 
      "CompletionTime": number,
      "ContentRedaction": { 
         "PiiEntityTypes": [ "string" ],
         "RedactionOutput": "string",
         "RedactionType": "string"
      },
      "CreationTime": number,
      "FailureReason": "string",
      "IdentifiedLanguageScore": number,
      "IdentifyLanguage": boolean,
      "IdentifyMultipleLanguages": boolean,
      "JobExecutionSettings": { 
         "AllowDeferredExecution": boolean,
         "DataAccessRoleArn": "string"
      },
      "LanguageCode": "string",
      "LanguageCodes": [ 
         { 
            "DurationInSeconds": number,
            "LanguageCode": "string"
         }
      ],
      "LanguageIdSettings": { 
         "string" : { 
            "LanguageModelName": "string",
            "VocabularyFilterName": "string",
            "VocabularyName": "string"
         }
      },
      "LanguageOptions": [ "string" ],
      "Media": { 
         "MediaFileUri": "string",
         "RedactedMediaFileUri": "string"
      },
      "MediaFormat": "string",
      "MediaSampleRateHertz": number,
      "ModelSettings": { 
         "LanguageModelName": "string"
      },
      "Settings": { 
         "ChannelIdentification": boolean,
         "MaxAlternatives": number,
         "MaxSpeakerLabels": number,
         "ShowAlternatives": boolean,
         "ShowSpeakerLabels": boolean,
         "VocabularyFilterMethod": "string",
         "VocabularyFilterName": "string",
         "VocabularyName": "string"
      },
      "StartTime": number,
      "Subtitles": { 
         "Formats": [ "string" ],
         "OutputStartIndex": number,
         "SubtitleFileUris": [ "string" ]
      },
      "Tags": [ 
         { 
            "Key": "string",
            "Value": "string"
         }
      ],
      "Transcript": { 
         "RedactedTranscriptFileUri": "string",
         "TranscriptFileUri": "string"
      },
      "TranscriptionJobName": "string",
      "TranscriptionJobStatus": "string"
   }
}
```

## 回應元素
<a name="API_GetTranscriptionJob_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [TranscriptionJob](#API_GetTranscriptionJob_ResponseSyntax) **   <a name="transcribe-GetTranscriptionJob-response-TranscriptionJob"></a>
提供有關指定轉錄工作的詳細資訊，包括工作狀態和失敗原因 (如果適用)。  
類型：[TranscriptionJob](API_TranscriptionJob.md) 物件

## 錯誤
<a name="API_GetTranscriptionJob_Errors"></a>

如需所有動作常見的錯誤相關資訊，請參閱[常見錯誤](CommonErrors.md)。

 ** BadRequestException **   
您的要求未通過一或多個驗證測試。當您嘗試刪除的實體不存在或處於非終端狀態（例如`IN PROGRESS`）時，可能會發生這種情況。如需詳細資訊，檢查「例外訊息」欄位。  
HTTP 狀態碼：400

 ** InternalFailureException **   
發生內部錯誤。檢查錯誤訊息，修正問題，然後再試一次您的要求。  
HTTP 狀態碼：500

 ** LimitExceededException **   
您可能傳送太多要求，或輸入檔案太長。請先等候再重試要求，或使用較小的檔案再試一次。  
HTTP 狀態碼：400

 ** NotFoundException **   
我們找不到要求的資源。請檢查指定的名稱是否正確，然後再試一次。  
HTTP 狀態碼：400

## 另請參閱
<a name="API_GetTranscriptionJob_SeeAlso"></a>

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
+  [AWS 命令列界面](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/GetTranscriptionJob) 
+  [適用於 .NET 的 AWS 開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/GetTranscriptionJob) 
+  [適用於 C\+\+ 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/GetTranscriptionJob) 
+  [適用於 Go 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/GetTranscriptionJob) 
+  [適用於 Java 的 AWS 開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/GetTranscriptionJob) 
+  [AWS適用於的 SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/GetTranscriptionJob) 
+  [適用於 PHP 的 AWS 開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/GetTranscriptionJob) 
+  [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/GetTranscriptionJob) 
+  [適用於 Ruby 的 AWS 開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/GetTranscriptionJob)