Acara registri - AWS IoT Core

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Acara 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, lihatAktifkan acara untuk AWS IoT.

Registri dapat menyediakan jenis acara berikut:

Peristiwa hal

Hal yang Dibuat/Diperbarui/Dihapus

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_EVENT”.

eventId

ID peristiwa unik (string).

timestamp

Stempel waktu UNIX saat peristiwa terjadi.

operation

Operasi yang memicu acara tersebut. Nilai yang valid adalah:

  • DIBUAT

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

hal TypeName

Jenis benda yang terkait dengan hal itu, jika ada. Atau, null.

atribut

Kumpulan pasangan nama-nilai yang terkait dengan benda tersebut.

Acara jenis hal

Tipe Benda yang Dibuat/Ulang/Tidak Diusang/Dihapus

Registri menerbitkan pesan peristiwa berikut ketika jenis sesuatu dibuat, 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" ], "description" : "My thing type" }

Muatan berisi atribut berikut:

eventType

Setel ke “THING_TYPE_EVENT”.

eventId

ID peristiwa unik (string).

timestamp

Stempel waktu UNIX saat peristiwa terjadi.

operation

Operasi yang memicu acara tersebut. Nilai yang valid adalah:

  • DIBUAT

  • DIPERBARUI

  • DELETED

accountId

Akun AWS ID Anda.

hal TypeId

ID dari jenis benda yang dibuat, tidak digunakan lagi, atau dihapus.

hal TypeName

Nama jenis benda yang dibuat, tidak digunakan lagi, atau dihapus.

isDeprecated

truejika 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.

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_TYPE_ASSOCIATION_EVENT”.

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.

hal TypeName

Jenis benda yang terkait dengan, atau tidak lagi terkait dengan, benda itu.

timestamp

Stempel waktu UNIX saat peristiwa terjadi.

Acara kelompok hal

Thing Group Dibuat/Diperbarui/Dihapus

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_GROUP_EVENT”.

eventId

ID peristiwa unik (string).

timestamp

Stempel waktu UNIX saat peristiwa terjadi.

operation

Operasi yang memicu acara tersebut. Nilai yang valid adalah:

  • DIBUAT

  • DIPERBARUI

  • DELETED

accountId

Akun AWS ID Anda.

hal GroupId

ID grup hal yang sedang dibuat, diperbarui, atau dihapus.

hal GroupName

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.

orang tua GroupName

Nama kelompok hal induk, jika ada.

orang tua GroupId

ID dari grup hal induk, jika ada.

deskripsi

Deskripsi dari kelompok benda.

akar ToParent ThingGroups

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 dangroupId.

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_GROUP_MEMBERSHIP_EVENT”.

eventId

ID acara.

timestamp

Stempel waktu UNIX untuk saat peristiwa terjadi.

operation

ADDEDketika sesuatu ditambahkan ke grup sesuatu. REMOVEDketika 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_GROUP_HIERARCHY_EVENT”.

eventId

ID acara.

timestamp

Stempel waktu UNIX untuk saat peristiwa terjadi.

operation

ADDEDketika sesuatu ditambahkan ke grup sesuatu. REMOVEDketika sesuatu dihapus dari kelompok sesuatu.

accountId

Akun AWS ID Anda.

hal GroupId

ID dari grup hal induk.

hal GroupName

Nama kelompok hal induk.

anak GroupId

ID grup benda anak.

anak GroupName

Nama kelompok benda anak.