기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 레지스트리 이벤트
레지스트리는 사물, 사물 유형 및 사물 그룹이 생성되거나, 업데이트되거나, 삭제될 때 이벤트 메시지를 게시할 수 있습니다. 그러나 이러한 이벤트는 기본적으로 사용할 수 없습니다. 이러한 이벤트를 설정하는 방법에 대한 자세한 내용은 [에 대한 이벤트 활성화 AWS IoT](iot-events.md#iot-events-enable) 섹션을 참조하세요.
**Topics**
+ [사물 이벤트](#registry-events-thing)
+ [사물 유형 이벤트](#registry-events-thingtype)
+ [사물 그룹 이벤트](#registry-events-thinggroup)
## 사물 이벤트
**사물 생성/업데이트/삭제됨**
레지스트리는 사물이 생성, 업데이트 또는 삭제될 때 다음과 같은 이벤트 메시지를 게시합니다.
+ `$aws/events/thing/{{thingName}}/created`
+ `$aws/events/thing/{{thingName}}/updated`
+ `$aws/events/thing/{{thingName}}/deleted`
메시지에는 아래와 같은 페이로드 예제가 포함됩니다.
```
{
"eventType" : "THING_EVENT",
"eventId" : "f5ae9b94-8b8e-4d8e-8c8f-b3266dd89853",
"timestamp" : 1234567890123,
"operation" : "CREATED|UPDATED|DELETED",
"accountId" : "123456789012",
"thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5",
"thingName" : "MyThing",
"versionNumber" : 1,
"thingTypeName" : null,
"attributes": {
"attribute3": "value3",
"attribute1": "value1",
"attribute2": "value2"
}
}
```
페이로드에는 다음과 같은 속성이 포함됩니다.
eventType
"THING\_EVENT"로 설정합니다.
eventId
고유한 이벤트 ID(문자열)입니다.
timestamp
이벤트가 발생한 시점의 UNIX 타임스탬프입니다.
작업
이벤트를 트리거한 작업입니다. 유효값은 다음과 같습니다.
+ CREATED
+ UPDATED
+ DELETED
accountId
AWS 계정 ID.
thingId
생성되거나, 업데이트되거나, 삭제된 사물의 ID입니다.
thingName
생성되거나, 업데이트되거나, 삭제된 사물의 이름입니다.
versionNumber
생성되거나, 업데이트되거나, 삭제된 사물의 버전입니다. 사물이 생성될 때는 이 값이 1로 설정됩니다. 이후 사물이 업데이트될 때마다 1씩 증가합니다.
thingTypeName
사물과 연결된 사물(있는 경우)의 유형입니다. 그렇지 않을 경우 `null`입니다.
attributes
사물과 연결된 이름-값 페어의 모음입니다.
## 사물 유형 이벤트
**Topics**
+ [사물 유형 생성/업데이트/사용 중지/사용 중지 해제/삭제](#registry-events-thingtype-crud)
+ [사물 유형을 사물과 연결/연결 해제](#registry-events-thingtype-assoc)
### 사물 유형 생성/업데이트/사용 중지/사용 중지 해제/삭제
레지스트리는 사물 유형이 생성, 업데이트, 사용 중지, 사용 중지 해제 또는 삭제될 때 다음과 같은 이벤트 메시지를 게시합니다.
+ `$aws/events/thingType/{{thingTypeName}}/created`
+ `$aws/events/thingType/{{thingTypeName}}/updated`
+ `$aws/events/thingType/{{thingTypeName}}/deleted`
메시지에는 아래와 같은 페이로드 예제가 포함됩니다.
```
{
"eventType" : "THING_TYPE_EVENT",
"eventId" : "8827376c-4b05-49a3-9b3b-733729df7ed5",
"timestamp" : 1234567890123,
"operation" : "CREATED|UPDATED|DELETED",
"accountId" : "123456789012",
"thingTypeId" : "c530ae83-32aa-4592-94d3-da29879d1aac",
"thingTypeName" : "MyThingType",
"isDeprecated" : false|true,
"deprecationDate" : null,
"searchableAttributes" : [ "attribute1", "attribute2", "attribute3" ],
"propagatingAttributes": [
{
"userPropertyKey": "key",
"thingAttribute": "model"
},
{
"userPropertyKey": "key",
"connectionAttribute": "iot:ClientId"
}
],
"description" : "My thing type"
}
```
페이로드에는 다음과 같은 속성이 포함됩니다.
eventType
"THING\_TYPE\_EVENT"로 설정합니다.
eventId
고유한 이벤트 ID(문자열)입니다.
timestamp
이벤트가 발생한 시점의 UNIX 타임스탬프입니다.
작업
이벤트를 트리거한 작업입니다. 유효값은 다음과 같습니다.
+ CREATED
+ UPDATED
+ DELETED
accountId
AWS 계정 ID.
thingTypeId
생성되거나, 업데이트되거나, 사용 중지되거나, 삭제된 사물 유형의 ID입니다.
thingTypeName
생성되거나, 업데이트되거나, 사용 중지되거나, 삭제된 사물 유형의 이름입니다.
isDeprecated
사물 유형의 사용이 중단된 경우에는 `true`입니다. 그렇지 않을 경우 `false`입니다.
deprecationDate
사물 유형의 사용이 중단된 시점의 UNIX 타임스탬프입니다.
searchableAttributes
검색에 사용할 수 있는 사물 유형과 연결된 이름-값 페어의 모음입니다.
propagatingAttributes
전파 속성 목록입니다. 전파 속성에는 사물 속성, 연결 속성 및 사용자 속성 키가 포함될 수 있습니다. 자세한 내용은 [메시지 보강을 위한 전파 속성 추가](https://docs.aws.amazon.com//iot/latest/developerguide/thing-types-propagating-attributes.html)를 참조하세요.
description
사물 유형에 대한 설명입니다.
### 사물 유형을 사물과 연결/연결 해제
레지스트리는 사물 유형이 사물과 연결 또는 연결 해제될 때 다음과 같은 이벤트 메시지를 게시합니다.
+ `$aws/events/thingTypeAssociation/thing/{{thingName}}/thingType/{{typeName}}/added`
+ `$aws/events/thingTypeAssociation/thing/{{thingName}}/thingType/{{typeName}}/removed`
다음은 `added` 페이로드의 예입니다. `removed` 메시지에 대한 페이로드는 유사합니다.
```
{
"eventId" : "87f8e095-531c-47b3-aab5-5171364d138d",
"eventType" : "THING_TYPE_ASSOCIATION_EVENT",
"operation" : "ADDED",
"thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5",
"thingName": "myThing",
"thingTypeName" : "MyThingType",
"timestamp" : 1234567890123,
}
```
페이로드에는 다음과 같은 속성이 포함됩니다.
eventId
고유한 이벤트 ID(문자열)입니다.
eventType
"THING\_TYPE\_ASSOCIATION\_EVENT"로 설정합니다.
작업
이벤트를 트리거한 작업입니다. 유효값은 다음과 같습니다.
+ ADDED
+ REMOVED
thingId
유형 연결이 변경된 사물의 ID입니다.
thingName
유형 연결이 변경된 사물의 이름입니다.
thingTypeName
사물과 연결되었거나 더 이상 연결되지 않은 사물 유형입니다.
timestamp
이벤트가 발생한 시점의 UNIX 타임스탬프입니다.
## 사물 그룹 이벤트
**Topics**
+ [사물 그룹 생성/업데이트/삭제](#registry-events-thinggroup-crud)
+ [사물 그룹에(서) 사물 추가/제거](#registry-events-thinggroup-addremove)
+ [사물 그룹에(서) 사물 그룹 추가/삭제](#registry-events-thinggroup-adddelete)
### 사물 그룹 생성/업데이트/삭제
레지스트리는 사물 그룹이 생성, 업데이트 또는 삭제될 때 다음과 같은 이벤트 메시지를 게시합니다.
+ `$aws/events/thingGroup/{{groupName}}/created`
+ `$aws/events/thingGroup/{{groupName}}/updated`
+ `$aws/events/thingGroup/{{groupName}}/deleted`
다음은 `updated` 페이로드의 예입니다. `created` 및 `deleted` 메시지에 대한 페이로드는 유사합니다.
```
{
"eventType": "THING_GROUP_EVENT",
"eventId": "8b9ea8626aeaa1e42100f3f32b975899",
"timestamp": 1603995417409,
"operation": "UPDATED",
"accountId": "571EXAMPLE833",
"thingGroupId": "8757eec8-bb37-4cca-a6fa-403b003d139f",
"thingGroupName": "Tg_level5",
"versionNumber": 3,
"parentGroupName": "Tg_level4",
"parentGroupId": "5fce366a-7875-4c0e-870b-79d8d1dce119",
"description": "New description for Tg_level5",
"rootToParentThingGroups": [
{
"groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/TgTopLevel",
"groupId": "36aa0482-f80d-4e13-9bff-1c0a75c055f6"
},
{
"groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level1",
"groupId": "bc1643e1-5a85-4eac-b45a-92509cbe2a77"
},
{
"groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level2",
"groupId": "0476f3d2-9beb-48bb-ae2c-ea8bd6458158"
},
{
"groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level3",
"groupId": "1d9d4ffe-a6b0-48d6-9de6-2e54d1eae78f"
},
{
"groupArn": "arn:aws:iot:us-west-2:571EXAMPLE833:thinggroup/Tg_level4",
"groupId": "5fce366a-7875-4c0e-870b-79d8d1dce119"
}
],
"attributes": {
"attribute1": "value1",
"attribute3": "value3",
"attribute2": "value2"
},
"dynamicGroupMappingId": null
}
```
페이로드에는 다음과 같은 속성이 포함됩니다.
eventType
"THING\_GROUP\_EVENT"로 설정합니다.
eventId
고유한 이벤트 ID(문자열)입니다.
timestamp
이벤트가 발생한 시점의 UNIX 타임스탬프입니다.
작업
이벤트를 트리거한 작업입니다. 유효값은 다음과 같습니다.
+ CREATED
+ UPDATED
+ DELETED
accountId
AWS 계정 ID.
thingGroupId
생성되거나, 업데이트되거나, 삭제된 사물 그룹의 ID입니다.
thingGroupName
생성되거나, 업데이트되거나, 삭제된 사물 그룹의 이름입니다.
versionNumber
사물 그룹 버전입니다. 사물 그룹이 생성될 때는 이 값이 1로 설정됩니다. 이후 사물 그룹이 업데이트될 때마다 1씩 증가합니다.
parentGroupName
상위 사물 그룹(있는 경우)의 이름입니다.
parentGroupId
상위 사물 그룹(있는 경우)의 ID입니다.
description
사물 그룹에 대한 설명입니다.
rootToParentThingGroups
상위 사물 그룹에 대한 정보의 배열입니다. 각 상위 사물 그룹에 대한 요소가 한 가지 있으며, 이는 루트 사물 그룹에서 시작하여 사물 그룹의 상위까지 계속됩니다. 각 항목에는 사물 그룹의 `groupArn` 및 `groupId`이(가) 포함됩니다.
attributes
사물 그룹과 연결된 이름-값 페어의 모음입니다.
### 사물 그룹에(서) 사물 추가/제거
레지스트리는 사물이 사물 그룹에 추가되거나 사물 그룹에서 제거될 때 다음과 같은 이벤트 메시지를 게시합니다.
+ `$aws/events/thingGroupMembership/thingGroup/{{thingGroupName}}/thing/{{thingName}}/added`
+ `$aws/events/thingGroupMembership/thingGroup/{{thingGroupName}}/thing/{{thingName}}/removed`
메시지에는 아래와 같은 페이로드 예제가 포함됩니다.
```
{
"eventType" : "THING_GROUP_MEMBERSHIP_EVENT",
"eventId" : "d684bd5f-6f6e-48e1-950c-766ac7f02fd1",
"timestamp" : 1234567890123,
"operation" : "ADDED|REMOVED",
"accountId" : "123456789012",
"groupArn" : "arn:aws:iot:ap-northeast-2:123456789012:thinggroup/MyChildThingGroup",
"groupId" : "06838589-373f-4312-b1f2-53f2192291c4",
"thingArn" : "arn:aws:iot:ap-northeast-2:123456789012:thing/MyThing",
"thingId" : "b604f69c-aa9a-4d4a-829e-c480e958a0b5",
"membershipId" : "8505ebf8-4d32-4286-80e9-c23a4a16bbd8"
}
```
페이로드에는 다음과 같은 속성이 포함됩니다.
eventType
"THING\_GROUP\_MEMBERSHIP\_EVENT"로 설정합니다.
eventId
이벤트 ID입니다.
timestamp
이벤트가 발생한 시점의 UNIX 타임스탬프입니다.
작업
사물이 사물 그룹에 추가된 경우에는 `ADDED`을(를) 게시합니다. 사물이 사물 그룹에서 제거된 경우에는 `REMOVED`을(를) 게시합니다.
accountId
AWS 계정 ID.
groupArn
사물 그룹의 ARN입니다.
groupId
그룹의 ID입니다.
thingArn
사물 그룹에 추가되거나, 혹은 사물 그룹에서 제거된 사물의 ARN입니다.
thingId
사물 그룹에 추가되거나, 혹은 사물 그룹에서 제거된 사물의 ID입니다.
membershipId
사물과 사물 그룹의 관계를 나타내는 ID입니다. 이 값은 사물을 사물 그룹에 추가할 때 생성됩니다.
### 사물 그룹에(서) 사물 그룹 추가/삭제
레지스트리는 사물 그룹이 다른 사물 그룹에 추가되거나 사물 그룹에서 제거될 때 다음과 같은 이벤트 메시지를 게시합니다.
+ `$aws/events/thingGroupHierarchy/thingGroup/{{parentThingGroupName}}/childThingGroup/{{childThingGroupName}}/added`
+ `$aws/events/thingGroupHierarchy/thingGroup/{{parentThingGroupName}}/childThingGroup/{{childThingGroupName}}/removed`
메시지에는 아래와 같은 페이로드 예제가 포함됩니다.
```
{
"eventType" : "THING_GROUP_HIERARCHY_EVENT",
"eventId" : "264192c7-b573-46ef-ab7b-489fcd47da41",
"timestamp" : 1234567890123,
"operation" : "ADDED|REMOVED",
"accountId" : "123456789012",
"thingGroupId" : "8f82a106-6b1d-4331-8984-a84db5f6f8cb",
"thingGroupName" : "MyRootThingGroup",
"childGroupId" : "06838589-373f-4312-b1f2-53f2192291c4",
"childGroupName" : "MyChildThingGroup"
}
```
페이로드에는 다음과 같은 속성이 포함됩니다.
eventType
"THING\_GROUP\_HIERARCHY\_EVENT"로 설정합니다.
eventId
이벤트 ID입니다.
timestamp
이벤트가 발생한 시점의 UNIX 타임스탬프입니다.
작업
사물이 사물 그룹에 추가된 경우에는 `ADDED`을(를) 게시합니다. 사물이 사물 그룹에서 제거된 경우에는 `REMOVED`을(를) 게시합니다.
accountId
AWS 계정 ID.
thingGroupId
상위 사물 그룹의 ID입니다.
thingGroupName
상위 사물 그룹의 이름입니다.
childGroupId
하위 사물 그룹의 ID입니다.
childGroupName
하위 사물 그룹의 이름입니다.