Peristiwa benda Peristiwa jenis benda Acara kelompok benda

Peristiwa registri

Registry dapat mempublikasikan pesan acara ketika hal-hal, jenis benda, dan grup benda dibuat, diperbarui, atau dihapus. Peristiwa ini, bagaimanapun, tidak tersedia secara default. Untuk informasi tentang cara mengaktifkan acara ini, lihatAktifkan acara untuk AWS IoT.

Registry dapat menyediakan jenis acara berikut:

Peristiwa benda
Peristiwa jenis benda
Acara kelompok benda

Peristiwa benda

Hal Created/Updated/Deleted

Registry 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"
    }
}

Payload berisi atribut berikut:

eventType

Setel ke “THING_EVENT”.

EvenTid

ID peristiwa unik (string).

timestamp

Stempel waktu UNIX saat peristiwa terjadi.

operation

Operasi yang memicu peristiwa tersebut. Nilai yang valid adalah:

CREATED
DIPERBARUI
DELETED

accountId

Akun AWS ID Anda.

ID benda

ID benda yang sedang dibuat, diperbarui, atau dihapus.

Nama benda

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. Itu bertambah 1 setiap kali hal diperbarui.

hal TypeName

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

atribut

Kumpulan pasangan nama-nilai yang terkait dengan benda tersebut.

Peristiwa jenis benda

Acara terkait jenis hal:

Jenis benda Created/Updated/Deprecated/Undeprecated/Deleted
Jenis Benda yang Terkait atau Tidak Terkait dengan Suatu Hal

Jenis benda Created/Updated/Deprecated/Undeprecated/Deleted

Registry menerbitkan pesan peristiwa berikut ketika jenis benda 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"
}

Payload 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 peristiwa tersebut. Nilai yang valid adalah:

CREATED
DIPERBARUI
DELETED

accountId

Akun AWS ID Anda.

hal TypeId

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

hal TypeName

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

IS Tidak digunakan lagi

truejika jenis benda itu tidak digunakan lagi. Atau, false.

Tanggal kedaluwarsa

Stempel waktu UNIX untuk saat jenis benda tidak digunakan lagi.

Atribut yang dapat dicari

Kumpulan pasangan nama-nilai yang terkait dengan jenis benda yang dapat digunakan untuk mencari.

Menyebarkan Atribut

Daftar atribut penyebaran. Atribut propagating dapat berisi atribut benda, atribut koneksi, dan kunci properti pengguna. Untuk informasi selengkapnya, lihat Menambahkan atribut penyebaran untuk pengayaan pesan.

deskripsi

Deskripsi dari jenis benda.

Jenis Benda yang Terkait atau Tidak Terkait dengan Suatu Hal

Registry 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,
}

Payload berisi atribut berikut:

EvenID

ID peristiwa unik (string).

eventType

Setel ke “THING_TYPE_ASSOCIATION_EVENT”.

operation

Operasi yang memicu peristiwa tersebut. Nilai yang valid adalah:

DITAMBAHKAN
DIHAPUS

ID benda

ID benda yang asosiasi tipenya diubah.

Nama benda

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 benda

Acara terkait kelompok hal:

Grup Hal Created/Updated/Deleted
Hal yang Ditambahkan ke atau Dihapus dari Grup Hal
Grup Hal Ditambahkan ke atau Dihapus dari Grup Hal

Grup Hal Created/Updated/Deleted

Registry menerbitkan pesan peristiwa berikut ketika grup benda 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
}

Payload berisi atribut berikut:

eventType

Setel ke “THING_GROUP_EVENT”.

EvenID

ID peristiwa unik (string).

timestamp

Stempel waktu UNIX saat peristiwa terjadi.

operation

Operasi yang memicu peristiwa tersebut. Nilai yang valid adalah:

CREATED
DIPERBARUI
DELETED

accountId

Akun AWS ID Anda.

hal GroupId

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

hal GroupName

Nama grup benda yang sedang dibuat, diperbarui, atau dihapus.

Nomor versi

Versi dari kelompok benda. Nilai ini diatur ke 1 ketika grup benda dibuat. Itu bertambah 1 setiap kali grup benda diperbarui.

orang tua GroupName

Nama kelompok benda induk, jika ada.

orang tua GroupId

ID grup benda induk, jika ada.

deskripsi

Deskripsi dari kelompok benda.

akar ToParentThingGroups

Array informasi tentang kelompok benda induk. Ada satu elemen untuk setiap kelompok benda induk, mulai dari kelompok hal akar 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 Grup Hal

Registry menerbitkan pesan peristiwa berikut ketika sesuatu ditambahkan ke atau dihapus dari grup benda.

$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"
}

Payload berisi atribut berikut:

eventType: Setel ke “THING_GROUP_MEMBERSHIP_EVENT”.
EvenID: ID peristiwa.
timestamp: Stempel waktu UNIX untuk saat peristiwa terjadi.
operation: ADDEDketika sesuatu ditambahkan ke grup benda. REMOVEDketika sesuatu dihapus dari kelompok benda.
accountId: Akun AWS ID Anda.
GroupArn: ARN dari kelompok benda.
groupId: ID grup.
ThingArn: ARN dari benda yang ditambahkan atau dihapus dari grup benda.
ID benda: ID benda yang ditambahkan atau dihapus dari grup benda.
ID Keanggotaan: ID yang mewakili hubungan antara benda dan kelompok benda. Nilai ini dihasilkan ketika Anda menambahkan sesuatu ke grup benda.

Grup Hal Ditambahkan ke atau Dihapus dari Grup Hal

Registry menerbitkan pesan peristiwa berikut ketika grup benda ditambahkan ke atau dihapus dari grup benda 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"
}

Payload berisi atribut berikut:

eventType: Setel ke “THING_GROUP_HIERARCHY_EVENT”.
EvenID: ID peristiwa.
timestamp: Stempel waktu UNIX untuk saat peristiwa terjadi.
operation: ADDEDketika sesuatu ditambahkan ke grup benda. REMOVEDketika sesuatu dihapus dari kelompok benda.
accountId: Akun AWS ID Anda.
hal GroupId: ID grup benda induk.
hal GroupName: Nama kelompok benda induk.
anak GroupId: ID kelompok benda anak.
anak GroupName: Nama kelompok hal 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 peristiwa

Peristiwa tugas