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

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

이 섹션에는 사물 또는 작업이 업데이트되거나 변경될 AWS IoT 때에서 게시한 메시지에 대한 정보가 포함되어 있습니다.

## 이벤트 메시지 생성 방법
<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}}"
  ```

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

[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`<br />`$aws/events/thingTypeAssociation/thing/{{thingName}}/thingType/{{thingTypeName}}/removed` |