쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

레지스트리 이벤트

포커스 모드
레지스트리 이벤트 - AWS IoT Core

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

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

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

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

사물 이벤트

사물 Created/Updated/Deleted

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

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

  • DELETED

accountId

AWS 계정 ID.

thingId

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

thingName

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

versionNumber

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

thingTypeName

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

attributes

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

사물 유형 이벤트

사물 유형 Created/Updated/Deprecated/Undeprecated/Deleted

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

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

타임스탬프

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

작업

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

  • CREATED

  • UPDATED

  • DELETED

accountId

AWS 계정 ID.

thingTypeId

생성, 업데이트, 사용 중지 또는 삭제되는 사물 유형의 ID입니다.

thingTypeName

생성, 업데이트, 사용 중지 또는 삭제되는 사물 유형의 이름입니다.

isDeprecated

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

deprecationDate

사물 유형이 더 이상 사용되지 않는 시점의 UNIX 타임스탬프입니다.

searchableAttributes

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

propagatingAttributes

전파 속성 목록입니다. 전파 속성에는 사물 속성, 연결 속성 및 사용자 속성 키가 포함될 수 있습니다. 자세한 내용은 메시지 보강을 위한 전파 속성 추가를 참조하세요.

설명

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

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

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

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

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

타임스탬프

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

사물 그룹 이벤트

사물 그룹 Created/Updated/Deleted

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

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

  • DELETED

accountId

AWS 계정 ID.

thingGroupId

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

thingGroupName

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

versionNumber

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

parentGroupName

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

parentGroupId

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

설명

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

rootToParentThingGroups

상위 사물 그룹에 대한 정보의 배열입니다. 각 상위 사물 그룹에 대한 요소가 한 가지 있으며, 이는 루트 사물 그룹에서 시작하여 사물 그룹의 상위까지 계속됩니다. 각 항목에는 사물 그룹의 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 계정 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입니다.

타임스탬프

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

작업

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

accountId

AWS 계정 ID.

thingGroupId

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

thingGroupName

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

childGroupId

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

childGroupName

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

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.