Peristiwa hal Acara jenis hal Acara kelompok hal

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
Acara jenis hal
Acara kelompok hal

Peristiwa hal

Benda 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_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.

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

Jenis hal terkait peristiwa:

Tipe Benda Created/Updated/Deprecated/Undeprecated/Deleted
Tipe Hal yang Terkait atau Terputus dengan Sesuatu

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

thingTypeId

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

thingTypeName

Nama jenis benda yang dibuat, diperbarui, 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.

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.

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

thingTypeName

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:

Kelompok Hal Created/Updated/Deleted
Hal yang Ditambahkan ke atau Dihapus dari Thing Group
Thing Group Ditambahkan atau Dihapus dari Thing Group

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

thingGroupId

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

atribut

Kumpulan pasangan nama-nilai yang terkait dengan grup benda.

Hal yang Ditambahkan ke 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.
thingGroupId: ID dari grup hal induk.
thingGroupName: Nama kelompok hal induk.
childGroupId: ID grup benda anak.
childGroupName: Nama kelompok benda anak.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Pesan kejadian

Acara Lowongan