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
Jenis hal terkait peristiwa:
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
-
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.
- 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
Acara terkait 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
-
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_GROUP_HIERARCHY_EVENT”.
- 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.
- 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.