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

# 이벤트 메시지
<a name="iot-events"></a>

이 섹션에는 사물 또는 작업이 업데이트되거나 변경될 AWS IoT 때에서 게시한 메시지에 대한 정보가 포함되어 있습니다. 디바이스의 장애 또는 작동 변경을 모니터링하고 디바이스가 발생할 때 작업을 트리거할 수 있는 감지기를 생성할 수 있는 AWS IoT Events 서비스에 대한 자세한 내용은 섹션을 참조하세요[AWS IoT Events](https://aws.amazon.com/iot-events).

## 이벤트 메시지 생성 방법
<a name="iot-events-how"></a>

AWS IoT 는 특정 이벤트가 발생할 때 이벤트 메시지를 게시합니다. 예를 들어 이벤트는 사물이 추가되거나, 업데이트되거나, 삭제될 때 레지스트리에 의해 생성됩니다. 이러한 이벤트가 발생할 때마다 단일 이벤트 메시지가 전송됩니다. 전송된 이벤트 메시지는 MQTT를 통해 JSON 페이로드와 함께 게시됩니다. 페이로드 내용은 이벤트 유형에 따라 달라집니다.

**참고**  
이벤트 메시지의 게시는 1회까지 보장됩니다. 하지만 1회 이상 게시하는 것도 가능합니다. 이벤트 메시지의 순서는 보장되지 않습니다.

### 이벤트 메시지 수신 정책
<a name="iot-events-policy"></a>

이벤트 메시지를 수신하려면 디바이스가 AWS IoT 디바이스 게이트웨이에 연결하고 MQTT 이벤트 주제를 구독하도록 허용하는 적절한 정책을 사용해야 합니다. 또한 적합한 주제 필터도 구독해야 합니다.

다음은 수명 주기 이벤트를 수신하는 데 필요한 정책의 예입니다.

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Subscribe",
                "iot:Receive"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:/$aws/events/*"
            ]
        }
    ]
}
```

## 에 대한 이벤트 활성화 AWS IoT
<a name="iot-events-enable"></a>

예약된 주제의 구독자가 메시지를 수신하려면 먼저에서 또는 API AWS Management Console 또는 CLI를 사용하여 이벤트 메시지를 활성화해야 합니다. 다양한 옵션에서 관리하는 이벤트 메시지에 대한 자세한 내용은 [AWS IoT 이벤트 구성 설정 테이블](#iot-events-settings-table)을 참조하세요.
+ 이벤트 메시지를 활성화하려면 AWS IoT 콘솔의 [설정](https://console.aws.amazon.com//iot/home#/settings) 탭으로 이동한 다음 **이벤트 기반 메시지** 섹션에서 **이벤트 관리를** 선택합니다. 관리할 이벤트를 지정할 수 있습니다.
+ API 또는 CLI를 사용하여 게시할 이벤트 유형을 제어하려면 [UpdateEventConfigurations](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateEventConfigurations.html) API를 호출하거나 **update-event-configurations** CLI 명령을 사용합니다. 예:

  ```
  aws iot update-event-configurations --event-configurations "{\"THING\":{\"Enabled\": true}}"
  ```

**참고**  
모든 큰따옴표(")는 백슬래시(\$1)로 이스케이프됩니다.

[DescribeEventConfigurations](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEventConfigurations.html) API를 호출하거나 **describe-event-configurations** CLI 명령을 사용하여 현재 이벤트 구성을 가져올 수 있습니다. 예:.

```
aws iot describe-event-configurations
```<a name="iot-events-settings-table"></a>

** AWS IoT 이벤트 구성 설정 표**


|  이벤트 범주  (AWS IoT 콘솔: 설정: 이벤트 기반 메시지)  |  `eventConfigurations` 키 값 (AWS CLI/API)  |    이벤트 메시지 주제  | 
| --- | --- | --- | 
|  *( AWS CLI/API를 사용해서만 구성할 수 있음)*  |  `CA_CERTIFICATE`  |  `$aws/events/certificates/registered/caCertificateId`  | 
|  *( AWS CLI/API를 사용해서만 구성할 수 있음)*  |  `CERTIFICATE`  |  `$aws/events/presence/connected/clientId`  | 
|  *( AWS CLI/API를 사용해서만 구성할 수 있음)*  |  `CERTIFICATE`  |  `$aws/events/presence/disconnected/clientId`  | 
|  *( AWS CLI/API를 사용해서만 구성할 수 있음)*  |  `CERTIFICATE`  |  `$aws/events/subscriptions/subscribed/clientId`  | 
|  *( AWS CLI/API를 사용해서만 구성할 수 있음)*  |  `CERTIFICATE`  |  `$aws/events/subscriptions/unsubscribed/clientId`  | 
|  작업 완료됨, 취소됨  |  `JOB`  |  `$aws/events/job/jobID/canceled`  | 
|  작업 완료됨, 취소됨  |  `JOB`  |  `$aws/events/job/jobID/cancellation_in_progress`  | 
|  작업 완료됨, 취소됨  |  `JOB`  |  `$aws/events/job/jobID/completed`  | 
|  작업 완료됨, 취소됨  |  `JOB`  |  `$aws/events/job/jobID/deleted`  | 
|  작업 완료됨, 취소됨  |  `JOB`  |  `$aws/events/job/jobID/deletion_in_progress`  | 
|  작업 실행: 성공, 실패, 거부됨, 취소됨, 제거됨  |  `JOB_EXECUTION`  |  `$aws/events/jobExecution/jobID/canceled`  | 
|  작업 실행: 성공, 실패, 거부됨, 취소됨, 제거됨  |  `JOB_EXECUTION`  |  `$aws/events/jobExecution/jobID/deleted`  | 
|  작업 실행: 성공, 실패, 거부됨, 취소됨, 제거됨  |  `JOB_EXECUTION`  |  `$aws/events/jobExecution/jobID/failed`  | 
|  작업 실행: 성공, 실패, 거부됨, 취소됨, 제거됨  |  `JOB_EXECUTION`  |  `$aws/events/jobExecution/jobID/rejected`  | 
|  작업 실행: 성공, 실패, 거부됨, 취소됨, 제거됨  |  `JOB_EXECUTION`  |  `$aws/events/jobExecution/jobID/removed`  | 
|  작업 실행: 성공, 실패, 거부됨, 취소됨, 제거됨  |  `JOB_EXECUTION`  |  `$aws/events/jobExecution/jobID/succeeded`  | 
|  작업 실행: 성공, 실패, 거부됨, 취소됨, 제거됨  |  `JOB_EXECUTION`  |  `$aws/events/jobExecution/jobID/timed_out`  | 
|  사물: 생성됨, 업데이트됨, 삭제됨  |  `THING`  |  `$aws/events/thing/thingName/created`  | 
|  사물: 생성됨, 업데이트됨, 삭제됨  |  `THING`  |  `$aws/events/thing/thingName/updated`  | 
|  사물: 생성됨, 업데이트됨, 삭제됨  |  `THING`  |  `$aws/events/thing/thingName/deleted`  | 
|  사물 그룹: 추가됨, 제거됨  |  `THING_GROUP`  |  `$aws/events/thingGroup/thingGroupName/created`  | 
|  사물 그룹: 추가됨, 제거됨  |  `THING_GROUP`  |  `$aws/events/thingGroup/thingGroupName/updated`  | 
|  사물 그룹: 추가됨, 제거됨  |  `THING_GROUP`  |  `$aws/events/thingGroup/thingGroupName/deleted`  | 
|  사물 그룹 계층: 추가됨, 제거됨  |  `THING_GROUP_HIERARCHY`  |  `$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/added`  | 
|  사물 그룹 계층: 추가됨, 제거됨  |  `THING_GROUP_HIERARCHY`  |  `$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/removed`  | 
|  사물 그룹 멤버십: 추가됨, 제거됨  |  `THING_GROUP_MEMBERSHIP`  |  `$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/added`  | 
|  사물 그룹 멤버십: 추가됨, 제거됨  |  `THING_GROUP_MEMBERSHIP`  |  `$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/removed`  | 
|  사물 유형: 생성됨, 업데이트됨, 삭제됨  |  `THING_TYPE`  |  `$aws/events/thingType/thingTypeName/created`  | 
|  사물 유형: 생성됨, 업데이트됨, 삭제됨  |  `THING_TYPE`  |  `$aws/events/thingType/thingTypeName/updated`  | 
|  사물 유형: 생성됨, 업데이트됨, 삭제됨  |  `THING_TYPE`  |  `$aws/events/thingType/thingTypeName/deleted`  | 
|  사물 유형 연결: 추가됨, 제거됨  |  `THING_TYPE_ASSOCIATION`  |  `$aws/events/thingTypeAssociation/thing/thingName/thingType/thingTypeName/added` `$aws/events/thingTypeAssociation/thing/thingName/thingType/thingTypeName/removed`  |