Jenis benda

Tipe hal mengizinkan Anda untuk menyimpan deskripsi dan informasi konfigurasi yang umum untuk semua hal yang berhubungan dengan tipe hal yang sama. Ini menyederhanakan pengelolaan hal-hal dalam registri. Misalnya, Anda dapat menentukan tipe LightBulb benda. Semua hal yang terkait dengan tipe LightBulb benda berbagi satu set atribut: nomor seri, pabrikan, dan watt. Saat Anda membuat sesuatu bertipe LightBulb (atau mengubah jenis benda yang ada menjadi LightBulb), Anda dapat menentukan nilai untuk setiap atribut yang ditentukan dalam tipe LightBulb benda.

Meskipun jenis benda bersifat opsional, penggunaannya membuatnya lebih mudah untuk menemukan sesuatu.

• Hal-hal dengan tipe hal dapat memiliki hingga 50 atribut.

• Hal-hal tanpa tipe hal dapat memiliki hingga tiga atribut.

• Suatu hal dapat dikaitkan dengan hanya satu tipe hal.

• Tidak ada batasan jumlah jenis barang yang dapat Anda buat di akun Anda.

Jenis benda tidak dapat diubah. Anda tidak dapat mengubah nama tipe benda setelah dibuat. Anda dapat menghentikan jenis barang kapan saja untuk mencegah hal-hal baru dikaitkan dengannya. Anda juga dapat menghapus jenis benda yang tidak memiliki hal-hal yang terkait dengannya.

Buat tipe benda

Anda dapat menggunakan CreateThingType perintah untuk membuat tipe sesuatu:

$ aws iot create-thing-type 

                --thing-type-name "LightBulb" --thing-type-properties "thingTypeDescription=light bulb type, searchableAttributes=wattage,model"

CreateThingTypePerintah mengembalikan respons yang berisi tipe benda dan ARN-nya:

{
    "thingTypeName": "LightBulb",
    "thingTypeId": "df9c2d8c-894d-46a9-8192-9068d01b2886",
    "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb"
}

Daftar jenis hal

Anda dapat menggunakan ListThingTypes perintah untuk membuat daftar jenis hal:

$ aws iot list-thing-types

ListThingTypesPerintah mengembalikan daftar jenis hal yang didefinisikan dalam Akun AWS:

{
    "thingTypes": [
        {
            "thingTypeName": "LightBulb",
            "thingTypeProperties": {
                "searchableAttributes": [
                    "wattage",
                    "model"
                ],
                "thingTypeDescription": "light bulb type"
            },
            "thingTypeMetadata": {
                "deprecated": false,
                "creationDate": 1468423800950
            }
        }
    ]
}

Jelaskan tipe benda

Anda dapat menggunakan DescribeThingType perintah untuk mendapatkan informasi tentang jenis benda:

$ aws iot describe-thing-type --thing-type-name "LightBulb"

DescribeThingTypePerintah mengembalikan informasi tentang jenis yang ditentukan:

{
    "thingTypeProperties": {
        "searchableAttributes": [
            "model", 
            "wattage"
        ], 
        "thingTypeDescription": "light bulb type"
    }, 
    "thingTypeId": "df9c2d8c-894d-46a9-8192-9068d01b2886", 
    "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb", 
    "thingTypeName": "LightBulb", 
    "thingTypeMetadata": {
        "deprecated": false, 
        "creationDate": 1544466338.399
    }
}

Kaitkan tipe benda dengan sesuatu

Anda dapat menggunakan CreateThing perintah untuk menentukan jenis benda saat Anda membuat sesuatu:

$ aws iot create-thing --thing-name "MyLightBulb" --thing-type-name "LightBulb" --attribute-payload "{\"attributes\": {\"wattage\":\"75\", \"model\":\"123\"}}"

Anda dapat menggunakan UpdateThing perintah kapan saja untuk mengubah jenis hal yang terkait dengan suatu hal:

$ aws iot update-thing --thing-name "MyLightBulb"
                --thing-type-name "LightBulb" --attribute-payload  "{\"attributes\": {\"wattage\":\"75\", \"model\":\"123\"}}"

Anda juga dapat menggunakan UpdateThing perintah untuk memisahkan sesuatu dari tipe benda.

Menghentikan tipe benda

Jenis benda tidak dapat diubah. Mereka tidak dapat diubah setelah didefinisikan. Namun, Anda dapat menghentikan tipe benda untuk mencegah pengguna mengaitkan hal-hal baru dengannya. Semua hal yang ada terkait dengan jenis benda tidak berubah.

Untuk menghentikan tipe benda, gunakan perintah: DeprecateThingType

$ aws iot deprecate-thing-type --thing-type-name "myThingType"

Anda dapat menggunakan DescribeThingType perintah untuk melihat hasilnya:

$ aws iot describe-thing-type --thing-type-name "StopLight":

{
    "thingTypeName": "StopLight",
    "thingTypeProperties": {
        "searchableAttributes": [
            "wattage",
            "numOfLights",
            "model"
        ],
        "thingTypeDescription": "traffic light type",
    },
    "thingTypeMetadata": {
        "deprecated": true,
        "creationDate": 1468425854308,
        "deprecationDate": 1468446026349
    }
}

Menghilangkan tipe benda adalah operasi yang dapat dibalik. Anda dapat membatalkan penghentian dengan menggunakan bendera dengan perintah --undo-deprecate CLI: DeprecateThingType

$ aws iot deprecate-thing-type --thing-type-name "myThingType" --undo-deprecate

Anda dapat menggunakan perintah DescribeThingType CLI untuk melihat hasilnya:

$ aws iot describe-thing-type --thing-type-name "StopLight":

{
    "thingTypeName": "StopLight",
    "thingTypeArn": "arn:aws:iot:us-east-1:123456789012:thingtype/StopLight",
    "thingTypeId": "12345678abcdefgh12345678ijklmnop12345678"
    "thingTypeProperties": {
        "searchableAttributes": [
            "wattage",
            "numOfLights",
            "model"
        ],
        "thingTypeDescription": "traffic light type"
    },
    "thingTypeMetadata": {
        "deprecated": false,
        "creationDate": 1468425854308,
    }
}

Hapus tipe benda

Anda dapat menghapus jenis benda hanya setelah mereka tidak digunakan lagi. Untuk menghapus tipe benda, gunakan DeleteThingType perintah:

$ aws iot delete-thing-type --thing-type-name "StopLight"

catatan

Sebelum Anda dapat menghapus jenis pengikat, tunggu selama lima menit setelah Anda menghentikannya.