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