기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 사용자 지정 분류를 위한 분석 작업(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 또는 Python용 SDK 사용](#get-started-api-customclass-java)

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

다음 예제는 `StartDocumentClassificationJob` 작업 및 AWS CLI를 사용한 기타 사용자 지정 분류기 API입니다.

다음 예제들은 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 또는 Python용 SDK 사용
<a name="get-started-api-customclass-java"></a>

사용자 지정 분류기 작업을 시작하는 방법에 대한 SDK 예제는 [AWS SDK 또는 CLI와 `StartDocumentClassificationJob` 함께 사용](example_comprehend_StartDocumentClassificationJob_section.md) 를 참조하세요.