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

# 이벤트 감지를 위한 비동기 분석
<a name="get-started-api-events"></a>

**Topics**
+ [시작하기 전에](#events-before)
+ [를 사용하여 이벤트 감지 AWS CLI](#events-cli)
+ [를 사용하여 이벤트 나열 AWS CLI](#list-events)
+ [를 사용하여 이벤트 설명 AWS CLI](#describe-events)
+ [이벤트 감지 결과 가져오기](#async-events)

문서 세트의 이벤트를 감지하려면 [StartEventsDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartEventsDetectionJob.html)을 사용하여 비동기 작업을 시작하십시오.

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

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

## 를 사용하여 이벤트 감지 AWS CLI
<a name="events-cli"></a>

다음 예제에서는에서 [StartEventsDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartEventsDetectionJob.html) 작업을 사용하는 방법을 보여줍니다. AWS CLI

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

```
aws comprehend start-events-detection-job \
  --region {{region}} \
  --job-name {{job name}} \
  --cli-input-json file://{{path to JSON input file}}
```

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

```
{
  "InputDataConfig": {
      "S3Uri": "s3://{{input bucket}}/{{input path}}",
      "InputFormat": "ONE_DOC_PER_LINE"
  },
  "OutputDataConfig": {
      "S3Uri": "s3://{{output bucket}}/{{output path}}"
  },
  "DataAccessRoleArn": "arn:aws:iam::{{account ID}}:role/{{data access role}}"
  "LanguageCode": "en",
  "TargetEventTypes": [
      "BANKRUPTCY",
      "EMPLOYMENT",
      "CORPORATE_ACQUISITION",
      "INVESTMENT_GENERAL",
      "CORPORATE_MERGER",
      "IPO",
      "RIGHTS_ISSUE",
      "SECONDARY_OFFERING",
      "SHELF_OFFERING",
      "TENDER_OFFERING",
      "STOCK_SPLIT"
  ]
}
```

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

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

## 를 사용하여 이벤트 나열 AWS CLI
<a name="list-events"></a>

제출한 이벤트 감지 작업의 목록을 보려면 [ListEventsDetectionJobs](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ListEventsDetectionJobs.html) 작업을 사용하십시오. 이 목록에는 사용한 입력 및 출력 위치와 각 감지 작업의 상태에 대한 정보가 포함됩니다. 다음은 Unix, Linux, macOS용 형식으로 지정된 예제입니다. Windows의 경우 각 줄의 끝에 있는 백슬래시(\\) Unix 연속 문자를 캐럿(^)으로 바꿉니다.

```
aws comprehend list-events-detection-jobs --region {{region}} 
```

응답은 다음과 비슷한 JSON 형식으로 받게 됩니다.

```
{
 "EventsDetectionJobPropertiesList": [
    {
       "DataAccessRoleArn": "arn:aws:iam::{{account ID}}:role/{{data access role}}",
       "EndTime": {{timestamp}},
       "InputDataConfig": {
          "InputFormat": "ONE_DOC_PER_LINE",
          "S3Uri": "s3://{{input bucket}}/{{input path}}"
       },
       "JobId": "{{job ID}}",
       "JobName": "{{job name}}",
       "JobStatus": "COMPLETED",
       "LanguageCode": "en",
       "Message": "{{message}}",
       "OutputDataConfig": {
          "S3Uri": "s3://{{output bucket}}/{{ouput path}}"
       },
       "SubmitTime": {{timestamp}},
       "TargetEventTypes": [
         "BANKRUPTCY",
         "EMPLOYMENT",
         "CORPORATE_ACQUISITION",
         "INVESTMENT_GENERAL",
         "CORPORATE_MERGER",
         "IPO",
         "RIGHTS_ISSUE",
         "SECONDARY_OFFERING",
         "SHELF_OFFERING",
         "TENDER_OFFERING",
         "STOCK_SPLIT"
  ]
    }
 ],
 "NextToken": "{{next token}}"
}
```

## 를 사용하여 이벤트 설명 AWS CLI
<a name="describe-events"></a>

[DescribeEventsDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeEventsDetectionJob.html) 작업을 사용하여 기존 작업의 상태를 얻을 수 있습니다. 다음은 Unix, Linux, macOS용 형식으로 지정된 예제입니다. Windows의 경우 각 줄의 끝에 있는 백슬래시(\\) Unix 연속 문자를 캐럿(^)으로 바꿉니다.

```
aws comprehend describe-events-detection-job \
  --region {{region}} \
  --job-id {{job ID}}
```

응답은 다음과 같은 JSON 형식으로 받게 됩니다.

```
{
 "EventsDetectionJobProperties": {
    "DataAccessRoleArn": "arn:aws:iam::{{account ID}}:role/{{data access role}}",
    "EndTime": {{timestamp}},
    "InputDataConfig": {
       "InputFormat": "ONE_DOC_PER_LINE",
       "S3Uri": "S3Uri": "s3://{{input bucket}}/{{input path}}"
    },
    "JobId": "{{job ID}}",
    "JobName": "{{job name}}",
    "JobStatus": "{{job status}}",
    "LanguageCode": "en",
    "Message": "{{message}}",
    "OutputDataConfig": {
       "S3Uri": "s3://{{output bucket}}/{{output path}}"
    },
    "SubmitTime": {{timestamp}},
    "TargetEventTypes": [
      "BANKRUPTCY",
      "EMPLOYMENT",
      "CORPORATE_ACQUISITION",
      "INVESTMENT_GENERAL",
      "CORPORATE_MERGER",
      "IPO",
      "RIGHTS_ISSUE",
      "SECONDARY_OFFERING",
      "SHELF_OFFERING",
      "TENDER_OFFERING",
      "STOCK_SPLIT"
  ]
 }
}
```

## 이벤트 감지 결과 가져오기
<a name="async-events"></a>

다음은 문서에서 이벤트를 감지한 분석 작업의 출력 파일 예제입니다. 입력 형식은 한 줄에 한 문서입니다.

```
{"Entities": [{"Mentions": [{"BeginOffset": 12, "EndOffset": 27, "GroupScore": 1.0, "Score": 0.916355, "Text": "over a year ago", "Type": "DATE"}]}, {"Mentions": [{"BeginOffset": 33, "EndOffset": 39, "GroupScore": 1.0, "Score": 0.996603, "Text": "Amazon", "Type": "ORGANIZATION"}]}, {"Mentions": [{"BeginOffset": 66, "EndOffset": 77, "GroupScore": 1.0, "Score": 0.999283, "Text": "Whole Foods", "Type": "ORGANIZATION"}]}], "Events": [{"Arguments": [{"EntityIndex": 2, "Role": "INVESTEE", "Score": 0.999283}, {"EntityIndex": 0, "Role": "DATE", "Score": 0.916355}, {"EntityIndex": 1, "Role": "INVESTOR", "Score": 0.996603}], "Triggers": [{"BeginOffset": 373, "EndOffset": 380, "GroupScore": 0.999984, "Score": 0.999955, "Text": "acquire", "Type": "CORPORATE_ACQUISITION"}], "Type": "CORPORATE_ACQUISITION"}, {"Arguments": [{"EntityIndex": 2, "Role": "PARTICIPANT", "Score": 0.999283}], "Triggers": [{"BeginOffset": 115, "EndOffset": 123, "GroupScore": 1.0, "Score": 0.999967, "Text": "combined", "Type": "CORPORATE_MERGER"}], "Type": "CORPORATE_MERGER"}], "File": "doc.txt", "Line": 0}
```

이벤트 출력 파일 구조와 지원되는 이벤트 유형에 대한 자세한 내용은 [이벤트](how-events.md)을 참조하세요.