기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
레지스트리는 사물, 사물 유형 및 사물 그룹이 생성되거나, 업데이트되거나, 삭제될 때 이벤트 메시지를 게시할 수 있습니다. 그러나 이러한 이벤트는 기본적으로 사용할 수 없습니다. 이러한 이벤트를 설정하는 방법에 대한 자세한 내용은 에 대한 이벤트 활성화 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
페이로드의 예입니다. 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(문자열)입니다.
- 타임스탬프
-
이벤트가 발생한 시간의 UNIX 타임스탬프입니다.
- 작업
-
이벤트를 트리거한 작업입니다. 유효한 값은 다음과 같습니다.
-
CREATED
-
UPDATED
-
DELETED
-
- accountId
-
AWS 계정 ID.
- thingGroupId
-
생성되거나, 업데이트되거나, 삭제된 사물 그룹의 ID입니다.
- thingGroupName
-
생성되거나, 업데이트되거나, 삭제된 사물 그룹의 이름입니다.
- versionNumber
-
사물 그룹 버전입니다. 사물 그룹이 생성될 때는 이 값이 1로 설정됩니다. 이후 사물 그룹이 업데이트될 때마다 1씩 증가합니다.
- parentGroupName
-
상위 사물 그룹(있는 경우)의 이름입니다.
- parentGroupId
-
상위 사물 그룹(있는 경우)의 ID입니다.
- 설명
-
사물 그룹에 대한 설명입니다.
- 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입니다.
- 타임스탬프
-
이벤트가 발생한 시점의 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
-
하위 사물 그룹의 이름입니다.