翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# カスタム分類の分析ジョブ (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)
+ [AWS SDK for Java または SDK for Python の使用](#get-started-api-customclass-java)

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

以下の例は、演算機能 `StartDocumentClassificationJob`、その他のカスタム分類子 API を 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
```

## AWS SDK for Java または SDK for Python の使用
<a name="get-started-api-customclass-java"></a>

カスタム分類子を開始する方法の SDK の例については、「[AWS SDK または CLI `StartDocumentClassificationJob`で を使用する](example_comprehend_StartDocumentClassificationJob_section.md)」を参照してください。