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

# 대상 감성에 대한 비동기 분석
<a name="using-api-targeted-sentiment"></a>

대상 감성의 실시간 분석에 대한 자세한 내용은 [대상 감성에 대한 실시간 분석](using-api-sync.md#get-started-api-targeted-sentiment)를 참조하세요.

Amazon Comprehend는 비동기 대상 감성 분석을 시작하고 관리하기 위한 다음 API 작업을 제공합니다.
+  [StartTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartTargetedSentimentDetectionJob.html) – 문서 모음에 대해 비동기 대상 감정 감지 작업 시작을 시작합니다.
+  [ListTargetedSentimentDetectionJobs](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ListTargetedSentimentDetectionJobs.html) – 제출한 대상 감성 감지 작업의 목록을 반환합니다.
+  [DescribeTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeTargetedSentimentDetectionJob.html) – 지정된 대상 감성 감지 작업과 관련된 속성(상태 포함)을 가져옵니다.
+  [StopTargetedSentimentDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StopTargetedSentimentDetectionJob.html) – 진행 중인 지정된 대상 감성 작업을 중지합니다.

**Topics**
+ [시작하기 전에](#api-targeted-sentiment-before)
+ [를 사용하여 대상 감성 분석 AWS CLI](#api-targeted-sentiment-cli)

## 시작하기 전에
<a name="api-targeted-sentiment-before"></a>

시작하기 전에 다음 사항을 확인해야 합니다.
+ **입력 및 출력 버킷** - 입력 및 출력에 사용할 Amazon S3 버킷을 식별합니다. 버킷은 사용자가 호출하는 API와 동일한 리전에 있어야 합니다.
+ **IAM 서비스 역할** - 입력 및 출력 버킷에 액세스하려면 권한이 있는 IAM 서비스 역할이 필요합니다. 자세한 내용은 [비동기 작업에 필요한 역할 기반 권한](security_iam_id-based-policy-examples.md#auth-role-permissions) 단원을 참조하십시오.

## 를 사용하여 대상 감성 분석 AWS CLI
<a name="api-targeted-sentiment-cli"></a>

다음 예제는 AWS CLI로 `StartTargetedSentimentDetectionJob` 작업을 사용하는 방법을 보여 줍니다. 이 예제는 입력 텍스트의 언어를 지정합니다.

다음은 Unix, Linux, macOS용 형식으로 지정된 예제입니다. Windows의 경우 각 줄의 끝에 있는 백슬래시(\$1) Unix 연속 문자를 캐럿(^)으로 바꿉니다.

```
aws comprehend start-targeted-sentiment-detection-job \
       --job-name "job name" \
       --language-code "en" \
       --cli-input-json file://path to JSON input file
```

`cli-input-json` 파라미터에는 다음 예시에 표시된 대로 요청 데이터가 포함된 JSON 파일의 경로를 제공해야 합니다.

```
{
    "InputDataConfig": {
        "S3Uri": "s3://input bucket/input path",
        "InputFormat": "ONE_DOC_PER_FILE"
    },
    "OutputDataConfig": {
        "S3Uri": "s3://output bucket/output path"
    },
    "DataAccessRoleArn": "arn:aws:iam::account ID:role/data access role"
}
```

작업 시작 요청이 성공하면 다음과 같은 응답을 받게 됩니다.

```
{
    "JobStatus": "SUBMITTED",
    "JobArn": "job ARN"
    "JobId": "job ID"
}
```