Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Cara mengelola sesuatu dengan registri
Anda menggunakan AWS IoT konsol, AWS IoT API, atau AWS CLI untuk berinteraksi dengan registri. Bagian berikut menunjukkan cara menggunakan CLI untuk bekerja dengan registri.
Saat menamai benda benda Anda:
-
Jangan gunakan informasi yang dapat diidentifikasi secara pribadi dalam nama barang Anda. Nama benda dapat muncul dalam komunikasi dan laporan yang tidak terenkripsi.
Buat sesuatu
Perintah berikut menunjukkan cara menggunakan AWS IoT CreateThing perintah dari CLI untuk membuat sesuatu. Anda tidak dapat mengubah nama sesuatu setelah Anda membuatnya. Untuk mengubah nama sesuatu, buat hal baru, berikan nama baru, lalu hapus yang lama.
$ aws iot create-thing --thing-name "MyLightBulb" --attribute-payload "{\"attributes\": {\"wattage\":\"75\", \"model\":\"123\"}}"
CreateThingPerintah menampilkan nama dan Amazon Resource Name (ARN) dari hal baru Anda:
{ "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyLightBulb", "thingName": "MyLightBulb", "thingId": "12345678abcdefgh12345678ijklmnop12345678" }
catatan
Kami tidak menyarankan menggunakan informasi identitas pribadi dalam nama barang Anda.
Untuk informasi selengkapnya, lihat create-thing dari Command Reference. AWS CLI
Daftar hal-hal
Anda dapat menggunakan ListThings perintah untuk membuat daftar semua hal di akun Anda:
$ aws iot list-things
{ "things": [ { "attributes": { "model": "123", "wattage": "75" }, "version": 1, "thingName": "MyLightBulb" }, { "attributes": { "numOfStates":"3" }, "version": 11, "thingName": "MyWallSwitch" } ] }
Anda dapat menggunakan ListThings perintah untuk mencari semua hal dari jenis hal tertentu:
$ aws iot list-things --thing-type-name "LightBulb"
{ "things": [ { "thingTypeName": "LightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 1, "thingName": "MyRGBLight" }, { "thingTypeName": "LightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 1, "thingName": "MySecondLightBulb" } ] }
Anda dapat menggunakan ListThings perintah untuk mencari semua hal yang memiliki atribut dengan nilai tertentu. Perintah ini mencari hingga tiga atribut.
$ aws iot list-things --attribute-name "wattage" --attribute-value "75"
{ "things": [ { "thingTypeName": "StopLight", "attributes": { "model": "123", "wattage": "75" }, "version": 3, "thingName": "MyLightBulb" }, { "thingTypeName": "LightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 1, "thingName": "MyRGBLight" }, { "thingTypeName": "LightBulb", "attributes": { "model": "123", "wattage": "75" }, "version": 1, "thingName": "MySecondLightBulb" } ] }
Untuk informasi selengkapnya, lihat daftar hal-hal dari Referensi AWS CLI Perintah.
Jelaskan hal-hal
Anda dapat menggunakan DescribeThing perintah untuk menampilkan informasi lebih rinci tentang suatu hal:
$ aws iot describe-thing --thing-name "MyLightBulb" { "version": 3, "thingName": "MyLightBulb", "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyLightBulb", "thingId": "12345678abcdefgh12345678ijklmnop12345678", "defaultClientId": "MyLightBulb", "thingTypeName": "StopLight", "attributes": { "model": "123", "wattage": "75" } }
Untuk informasi selengkapnya, lihat menjelaskan hal dari Referensi Perintah. AWS CLI
Perbarui sesuatu
Anda dapat menggunakan UpdateThing perintah untuk memperbarui sesuatu. Perintah ini hanya memperbarui atribut benda itu. Anda tidak dapat mengubah nama. Untuk mengubah nama sesuatu, buat hal baru, berikan nama baru, lalu hapus yang lama.
$ aws iot update-thing --thing-name "MyLightBulb" --attribute-payload "{\"attributes\": {\"wattage\":\"150\", \"model\":\"456\"}}"
UpdateThingPerintah tidak menghasilkan output. Anda dapat menggunakan DescribeThing perintah untuk melihat hasilnya:
$ aws iot describe-thing --thing-name "MyLightBulb" { "attributes": { "model": "456", "wattage": "150" }, "version": 2, "thingName": "MyLightBulb" }
Untuk informasi selengkapnya, lihat update-thing dari Command Reference. AWS CLI
Hapus sesuatu
Anda dapat menggunakan DeleteThing perintah untuk menghapus sesuatu:
$ aws iot delete-thing --thing-name "MyThing"
Perintah ini berhasil kembali tanpa kesalahan jika penghapusan berhasil atau Anda menentukan hal yang tidak ada.
Untuk informasi selengkapnya, lihat Hapus-hal dari Referensi AWS CLI Perintah.
Lampirkan kepala sekolah pada suatu hal
Perangkat fisik harus memiliki sertifikat X.509 untuk berkomunikasi. AWS IoT Anda dapat mengaitkan sertifikat di perangkat Anda dengan benda di registri yang mewakili perangkat Anda. Untuk melampirkan sertifikat ke barang Anda, gunakan AttachThingPrincipal perintah:
$ aws iot attach-thing-principal --thing-name "MyLightBulb" --principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847"
AttachThingPrincipalPerintah tidak menghasilkan output apa pun.
Untuk informasi selengkapnya, lihat attach-thing-principal dari Command Reference. AWS CLI
Lepaskan kepala sekolah dari suatu hal
Anda dapat menggunakan DetachThingPrincipal perintah untuk melepaskan sertifikat dari suatu hal:
$ aws iot detach-thing-principal --thing-name "MyLightBulb" --principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847"
DetachThingPrincipalPerintah tidak menghasilkan output apa pun.
Untuk informasi selengkapnya, lihat detach-thing-principal dari Command Reference. AWS CLI