레지스트리 이벤트 - AWS IoT Core

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

레지스트리 이벤트

레지스트리는 사물, 사물 유형 및 사물 그룹이 생성되거나, 업데이트되거나, 삭제될 때 이벤트 메시지를 게시할 수 있습니다. 그러나 이러한 이벤트는 기본적으로 사용할 수 없습니다. 이러한 이벤트를 설정하는 방법에 대한 자세한 내용은 다음과 같은 이벤트를 활성화합니다. AWS IoT 섹션을 참조하세요.

레지스트리에서 제공하는 이벤트 유형은 다음과 같습니다.

사물 이벤트

사물 생성/업데이트/삭제됨

레지스트리는 사물이 생성, 업데이트 또는 삭제될 때 다음과 같은 이벤트 메시지를 게시합니다.

  • $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(문자열)입니다.

타임스탬프

이벤트가 발생한 시점의 UNIX 타임스탬프입니다.

작업

이벤트를 트리거한 작업입니다. 유효한 값은 다음과 같습니다.

  • CREATED

  • UPDATED

  • 삭제됨

accountId

사용자 ID. AWS 계정

thingId

생성되거나, 업데이트되거나, 삭제된 사물의 ID입니다.

thingName

생성되거나, 업데이트되거나, 삭제된 사물의 이름입니다.

versionNumber

생성되거나, 업데이트되거나, 삭제된 사물의 버전입니다. 사물이 생성될 때는 이 값이 1로 설정됩니다. 이후 사물이 업데이트될 때마다 1씩 증가합니다.

물건 TypeName

사물과 연결된 사물(있는 경우)의 유형입니다. 그렇지 않을 경우 null입니다.

attributes

사물과 연결된 이름-값 페어의 모음입니다.

사물 유형 이벤트

사물 유형 생성/사용 중지/사용 중지 해제/삭제

레지스트리는 사물 유형이 생성, 사용 중지, 사용 중지 해제 또는 삭제될 때 다음과 같은 이벤트 메시지를 게시합니다.

  • $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" ], "description" : "My thing type" }

페이로드에는 다음과 같은 속성이 포함됩니다.

eventType

"THING_TYPE_EVENT"로 설정합니다.

eventId

고유한 이벤트 ID(문자열)입니다.

타임스탬프

이벤트가 발생한 시점의 UNIX 타임스탬프입니다.

작업

이벤트를 트리거한 작업입니다. 유효한 값은 다음과 같습니다.

  • CREATED

  • UPDATED

  • 삭제됨

accountId

네 AWS 계정 신분증.

물건 TypeId

생성되거나, 업데이트되거나, 삭제된 사물 유형의 ID입니다.

물건 TypeName

생성되거나, 업데이트되거나, 삭제된 사물 유형의 이름입니다.

isDeprecated

사물 유형의 사용이 중단된 경우에는 true입니다. 그렇지 않을 경우 false입니다.

deprecationDate

사물 유형의 사용이 중단된 시점의 UNIX 타임스탬프입니다.

searchableAttributes

검색에 사용할 수 있는 사물 유형과 연결된 이름-값 페어의 모음입니다.

설명

사물 유형에 대한 설명입니다.

사물 유형을 사물과 연결/연결 해제

레지스트리는 사물 유형이 사물과 연결 또는 연결 해제될 때 다음과 같은 이벤트 메시지를 게시합니다.

  • $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

유형 연결이 변경된 사물의 이름입니다.

물건 TypeName

사물과 연결되었거나 더 이상 연결되지 않은 사물 유형입니다.

타임스탬프

이벤트가 발생한 시점의 UNIX 타임스탬프입니다.

사물 그룹 이벤트

사물 그룹 생성/업데이트/삭제

레지스트리는 사물 그룹이 생성, 업데이트 또는 삭제될 때 다음과 같은 이벤트 메시지를 게시합니다.

  • $aws/events/thingGroup/groupName/created

  • $aws/events/thingGroup/groupName/updated

  • $aws/events/thingGroup/groupName/deleted

다음은 updated 페이로드의 예입니다. createddeleted 메시지에 대한 페이로드는 유사합니다.

{ "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(문자열)입니다.

타임스탬프

이벤트가 발생한 시점의 UNIX 타임스탬프입니다.

작업

이벤트를 트리거한 작업입니다. 유효한 값은 다음과 같습니다.

  • CREATED

  • UPDATED

  • 삭제됨

accountId

네 AWS 계정 신분증.

물건 GroupId

생성되거나, 업데이트되거나, 삭제된 사물 그룹의 ID입니다.

물건 GroupName

생성되거나, 업데이트되거나, 삭제된 사물 그룹의 이름입니다.

versionNumber

사물 그룹 버전입니다. 사물 그룹이 생성될 때는 이 값이 1로 설정됩니다. 이후 사물 그룹이 업데이트될 때마다 1씩 증가합니다.

부모 GroupName

상위 사물 그룹(있는 경우)의 이름입니다.

부모 GroupId

상위 사물 그룹(있는 경우)의 ID입니다.

설명

사물 그룹에 대한 설명입니다.

루트 ToParent ThingGroups

상위 사물 그룹에 대한 정보의 배열입니다. 각 상위 사물 그룹에 대한 요소가 한 가지 있으며, 이는 루트 사물 그룹에서 시작하여 사물 그룹의 상위까지 계속됩니다. 각 항목에는 사물 그룹의 groupArngroupId이(가) 포함됩니다.

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입니다.

타임스탬프

이벤트가 발생한 시점의 UNIX 타임스탬프입니다.

작업

사물이 사물 그룹에 추가된 경우에는 ADDED을(를) 게시합니다. 사물이 사물 그룹에서 제거된 경우에는 REMOVED을(를) 게시합니다.

accountId

당신의 AWS 계정 아이디.

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입니다.

타임스탬프

이벤트가 발생한 시점의 UNIX 타임스탬프입니다.

작업

사물이 사물 그룹에 추가된 경우에는 ADDED을(를) 게시합니다. 사물이 사물 그룹에서 제거된 경우에는 REMOVED을(를) 게시합니다.

accountId

당신의 AWS 계정 신분증.

물건 GroupId

상위 사물 그룹의 ID입니다.

물건 GroupName

상위 사물 그룹의 이름입니다.

어린이 GroupId

하위 사물 그룹의 ID입니다.

어린이 GroupName

하위 사물 그룹의 이름입니다.