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

# 自訂分類的分析任務 (API)
<a name="analysis-jobs-custom-class-api"></a>

[建立和訓練](train-custom-classifier-api.md)自訂文件分類器之後，您可以使用分類器來執行分析任務。

使用 [StartDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartDocumentClassificationJob.html) 操作開始分類未標記的文件。您可以指定包含輸入文件的 S3 儲存貯體、輸出文件的 S3 儲存貯體，以及要使用的分類器。

若要在訓練模型時達到最高層級的準確性，請將輸入類型與分類器模型類型配對。如果您將原生文件提交至純文字模型，或將純文字文件提交至原生文件模型，分類器任務會傳回警告。如需詳細資訊，請參閱[訓練分類模型](training-classifier-model.md)。

 [StartDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartDocumentClassificationJob.html) 是非同步的。開始任務後，請使用 [DescribeDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeDocumentClassificationJob.html) 操作來監控其進度。當回應中的 `Status` 欄位顯示 時`COMPLETED`，您可以在指定的位置存取輸出。

**Topics**
+ [使用 AWS Command Line Interface](#get-started-api-customclass-cli)
+ [使用適用於 Python 的 適用於 Java 的 AWS SDK 或 SDK](#get-started-api-customclass-java)

## 使用 AWS Command Line Interface
<a name="get-started-api-customclass-cli"></a>

下列範例為 `StartDocumentClassificationJob`操作，以及其他具有 APIs AWS CLI。

下列範例使用 Unix、Linux 和 macOS 的命令格式。用於 Windows 時，請以插入號 (^) 取代每一行結尾處的 Unix 接續字元斜線 (\$1)。

使用 `StartDocumentClassificationJob`操作執行自訂分類任務。

```
aws comprehend start-document-classification-job \
     --region region \
     --document-classifier-arn arn:aws:comprehend:region:account number:document-classifier/testDelete \
     --input-data-config S3Uri=s3://S3Bucket/docclass/file name,InputFormat=ONE_DOC_PER_LINE \
     --output-data-config S3Uri=s3://S3Bucket/output \
     --data-access-role-arn arn:aws:iam::account number:role/resource name
```

使用 `DescribeDocumentClassificationJob`操作取得具有任務 ID 的自訂分類器資訊。

```
aws comprehend describe-document-classification-job \
     --region region \
     --job-id job id
```

使用 `ListDocumentClassificationJobs`操作列出您帳戶中的所有自訂分類任務。

```
aws comprehend list-document-classification-jobs
     --region region
```

## 使用適用於 Python 的 適用於 Java 的 AWS SDK 或 SDK
<a name="get-started-api-customclass-java"></a>

如需如何啟動自訂分類器任務的 SDK 範例，請參閱 [`StartDocumentClassificationJob` 搭配 AWS SDK 或 CLI 使用](example_comprehend_StartDocumentClassificationJob_section.md)。