本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 自定义分类的分析任务 (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，请将每行末尾的反斜杠 (\$1) Unix 行继续符替换为脱字号 (^)。

使用 `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)。