Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Peristiwa registri
Registri dapat mempublikasikan pesan peristiwa ketika sesuatu, tipe benda, dan grup hal dibuat, diperbarui, atau dihapus. Peristiwa ini, bagaimanapun, tidak tersedia secara default. Untuk informasi tentang cara mengaktifkan acara ini, lihat[Aktifkan acara untuk AWS IoT](iot-events.md#iot-events-enable).
**Topics**
+ [Peristiwa hal](#registry-events-thing)
+ [Acara jenis hal](#registry-events-thingtype)
+ [Acara kelompok hal](#registry-events-thinggroup)
## Peristiwa hal
**Hal Created/Updated/Deleted**
Registri menerbitkan pesan peristiwa berikut ketika sesuatu dibuat, diperbarui, atau dihapus:
+ `$aws/events/thing/thingName/created`
+ `$aws/events/thing/thingName/updated`
+ `$aws/events/thing/thingName/deleted`
Pesan berisi contoh payload berikut:
```
{
"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"
}
}
```
Muatan berisi atribut berikut:
eventType
Setel ke “THING\$1EVENT”.
eventId
ID peristiwa unik (string).
timestamp
Stempel waktu UNIX saat peristiwa terjadi.
operation
Operasi yang memicu acara tersebut. Nilai yang valid adalah:
+ CREATED
+ DIPERBARUI
+ DELETED
accountId
Akun AWS ID Anda.
thingId
ID dari benda yang sedang dibuat, diperbarui, atau dihapus.
thingName
Nama benda yang sedang dibuat, diperbarui, atau dihapus.
versionNumber
Versi benda yang sedang dibuat, diperbarui, atau dihapus. Nilai ini diatur ke 1 ketika sesuatu dibuat. Ini bertambah 1 setiap kali hal diperbarui.
thingTypeName
Jenis benda yang terkait dengan hal itu, jika ada. Atau, `null`.
atribut
Kumpulan pasangan nama-nilai yang terkait dengan benda tersebut.
## Acara jenis hal
**Topics**
+ [Tipe Benda Created/Updated/Deprecated/Undeprecated/Deleted](#registry-events-thingtype-crud)
+ [Tipe Hal yang Terkait atau Terputus dengan Sesuatu](#registry-events-thingtype-assoc)
### Tipe Benda Created/Updated/Deprecated/Undeprecated/Deleted
Registri menerbitkan pesan peristiwa berikut ketika jenis sesuatu dibuat, diperbarui, tidak digunakan lagi, tidak digunakan lagi, atau dihapus:
+ `$aws/events/thingType/thingTypeName/created`
+ `$aws/events/thingType/thingTypeName/updated`
+ `$aws/events/thingType/thingTypeName/deleted`
Pesan berisi contoh payload berikut:
```
{
"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"
}
```
Muatan berisi atribut berikut:
eventType
Setel ke “THING\$1TYPE\$1EVENT”.
eventId
ID peristiwa unik (string).
timestamp
Stempel waktu UNIX saat peristiwa terjadi.
operation
Operasi yang memicu acara tersebut. Nilai yang valid adalah:
+ CREATED
+ DIPERBARUI
+ DELETED
accountId
Akun AWS ID Anda.
thingTypeId
ID dari jenis benda yang sedang dibuat, diperbarui, tidak digunakan lagi, atau dihapus.
thingTypeName
Nama jenis benda yang sedang dibuat, diperbarui, tidak digunakan lagi, atau dihapus.
isDeprecated
`true`jika tipe benda tidak digunakan lagi. Atau, `false`.
deprecationDate
Stempel waktu UNIX untuk saat tipe benda tidak digunakan lagi.
searchableAttributes
Kumpulan pasangan nama-nilai yang terkait dengan jenis benda yang dapat digunakan untuk pencarian.
Menyebarkan Atribut
Daftar atribut propagating. Atribut propagating dapat berisi atribut thing, atribut koneksi, dan kunci properti pengguna. Untuk informasi selengkapnya, lihat [Menambahkan atribut propagasi untuk pengayaan pesan](https://docs.aws.amazon.com//iot/latest/developerguide/thing-types-propagating-attributes.html).
deskripsi
Deskripsi jenis benda.
### Tipe Hal yang Terkait atau Terputus dengan Sesuatu
Registri menerbitkan pesan peristiwa berikut ketika jenis sesuatu dikaitkan atau dipisahkan dengan sesuatu.
+ `$aws/events/thingTypeAssociation/thing/thingName/thingType/typeName/added`
+ `$aws/events/thingTypeAssociation/thing/thingName/thingType/typeName/removed`
Berikut ini adalah contoh `added` payload. Muatan untuk `removed` pesan serupa.
```
{
"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,
}
```
Muatan berisi atribut berikut:
eventId
ID peristiwa unik (string).
eventType
Setel ke “THING\$1TYPE\$1ASSOCIATION\$1EVENT”.
operation
Operasi yang memicu acara tersebut. Nilai yang valid adalah:
+ DITAMBAHKAN
+ DIKELUARKAN
thingId
ID dari benda yang asosiasi tipenya diubah.
thingName
Nama benda yang asosiasi tipenya diubah.
thingTypeName
Jenis benda yang terkait dengan, atau tidak lagi terkait dengan, benda itu.
timestamp
Stempel waktu UNIX saat peristiwa terjadi.
## Acara kelompok hal
**Topics**
+ [Kelompok Hal Created/Updated/Deleted](#registry-events-thinggroup-crud)
+ [Hal yang Ditambahkan atau Dihapus dari Thing Group](#registry-events-thinggroup-addremove)
+ [Thing Group Ditambahkan atau Dihapus dari Thing Group](#registry-events-thinggroup-adddelete)
### Kelompok Hal Created/Updated/Deleted
Registri menerbitkan pesan peristiwa berikut ketika grup sesuatu dibuat, diperbarui, atau dihapus.
+ `$aws/events/thingGroup/groupName/created`
+ `$aws/events/thingGroup/groupName/updated`
+ `$aws/events/thingGroup/groupName/deleted`
Berikut ini adalah contoh `updated` payload. Muatan untuk `created` dan `deleted` pesan serupa.
```
{
"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
}
```
Muatan berisi atribut berikut:
eventType
Setel ke “THING\$1GROUP\$1EVENT”.
eventId
ID peristiwa unik (string).
timestamp
Stempel waktu UNIX saat peristiwa terjadi.
operation
Operasi yang memicu acara tersebut. Nilai yang valid adalah:
+ CREATED
+ DIPERBARUI
+ DELETED
accountId
Akun AWS ID Anda.
thingGroupId
ID grup hal yang sedang dibuat, diperbarui, atau dihapus.
thingGroupName
Nama grup benda yang sedang dibuat, diperbarui, atau dihapus.
versionNumber
Versi dari grup benda. Nilai ini diatur ke 1 ketika grup benda dibuat. Ini bertambah 1 setiap kali grup hal diperbarui.
parentGroupName
Nama kelompok hal induk, jika ada.
parentGroupId
ID dari grup hal induk, jika ada.
deskripsi
Deskripsi dari kelompok benda.
rootToParentThingGroups
Sebuah array informasi tentang kelompok hal induk. Ada satu elemen untuk setiap grup hal induk, mulai dari grup root thing dan berlanjut ke induk grup benda. Setiap entri berisi kelompok benda `groupArn` dan`groupId`.
atribut
Kumpulan pasangan nama-nilai yang terkait dengan grup benda.
### Hal yang Ditambahkan atau Dihapus dari Thing Group
Registri menerbitkan pesan peristiwa berikut ketika sesuatu ditambahkan atau dihapus dari grup sesuatu.
+ `$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/added`
+ `$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/removed`
Pesan berisi contoh payload berikut:
```
{
"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"
}
```
Muatan berisi atribut berikut:
eventType
Setel ke “THING\$1GROUP\$1MEMBERSHIP\$1EVENT”.
eventId
ID acara.
timestamp
Stempel waktu UNIX untuk saat peristiwa terjadi.
operation
`ADDED`ketika sesuatu ditambahkan ke grup sesuatu. `REMOVED`ketika sesuatu dihapus dari kelompok sesuatu.
accountId
Akun AWS ID Anda.
groupArn
ARN dari kelompok benda.
groupId
ID grup.
thingArn
ARN dari hal yang ditambahkan atau dihapus dari kelompok benda.
thingId
ID dari hal yang ditambahkan atau dihapus dari grup benda.
membershipId
ID yang mewakili hubungan antara benda dan kelompok benda. Nilai ini dihasilkan ketika Anda menambahkan sesuatu ke grup benda.
### Thing Group Ditambahkan atau Dihapus dari Thing Group
Registri menerbitkan pesan peristiwa berikut ketika grup sesuatu ditambahkan atau dihapus dari grup hal lain.
+ `$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/added`
+ `$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/removed`
Pesan berisi contoh payload berikut:
```
{
"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"
}
```
Muatan berisi atribut berikut:
eventType
Setel ke “THING\$1GROUP\$1HIERARCHY\$1EVENT”.
eventId
ID acara.
timestamp
Stempel waktu UNIX untuk saat peristiwa terjadi.
operation
`ADDED`ketika sesuatu ditambahkan ke grup sesuatu. `REMOVED`ketika sesuatu dihapus dari kelompok sesuatu.
accountId
Akun AWS ID Anda.
thingGroupId
ID dari grup hal induk.
thingGroupName
Nama kelompok hal induk.
childGroupId
ID grup benda anak.
childGroupName
Nama kelompok benda anak.