Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola hal-hal 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.
**Topics**
+ [
# Buat sesuatu
](create-thing.md)
+ [
# Daftar hal-hal
](list-things.md)
+ [
# Jelaskan hal-hal
](search-things.md)
+ [
# Perbarui sesuatu
](update-thing.md)
+ [
# Hapus sesuatu
](delete-thing.md)
+ [
# Lampirkan kepala sekolah pada suatu hal
](attach-thing-principal.md)
+ [
# Daftar hal-hal yang terkait dengan kepala sekolah
](list-principal-things.md)
+ [
# Daftar kepala sekolah yang terkait dengan suatu hal
](list-thing-principals.md)
+ [
# Buat daftar hal-hal yang terkait dengan prinsipal V2
](list-principal-things-v2.md)
+ [
# Daftar kepala sekolah yang terkait dengan sesuatu V2
](list-thing-principals-v2.md)
+ [
# Lepaskan kepala sekolah dari suatu hal
](detach-thing-principal.md)
# 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-type-name "MyLightBulb" \
--attribute-payload "{\"attributes\": {\"wattage\":\"75\", \"model\":\"123\"}}"
```
**CreateThing**Perintah 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](https://docs.aws.amazon.com//cli/latest/reference/iot/create-thing.html) 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](https://docs.aws.amazon.com//cli/latest/reference/iot/list-things.html) AWS CLI Perintah.
# Jelaskan hal-hal
Anda dapat menggunakan **DescribeThing** perintah untuk menampilkan informasi yang 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"
}
}
```
Anda juga dapat mengakses API ini dalam mesin aturan menggunakan fungsi `get_registry_data()` inline. Anda dapat menggunakan fungsi ini untuk secara dinamis mengakses dan memanfaatkan informasi registri benda (termasuk atribut, tipe benda, dan keanggotaan grup) dengan memanggil `DescribeThing` dan `ListThingGroupsForThing` APIs langsung dalam AWS IoT aturan, memungkinkan pemrosesan dan perutean pesan real-time berdasarkan data registri perangkat Anda. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com//iot/latest/developerguide/iot-sql-functions.html#iot-sql-function-get-registry_data](https://docs.aws.amazon.com//iot/latest/developerguide/iot-sql-functions.html#iot-sql-function-get-registry_data).
Untuk informasi selengkapnya, lihat [menjelaskan hal dari Referensi](https://docs.aws.amazon.com//cli/latest/reference/iot/describe-thing.html) 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\"}}"
```
**UpdateThing**Perintah 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](https://docs.aws.amazon.com//cli/latest/reference/iot/update-thing.html) 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](https://docs.aws.amazon.com//cli/latest/reference/iot/delete-thing.html) AWS CLI Perintah.
# Lampirkan kepala sekolah pada suatu hal
Perangkat fisik dapat menggunakan prinsipal untuk berkomunikasi dengan AWS IoT. Prinsipal dapat berupa sertifikat X.509 atau ID Amazon Cognito. Anda dapat mengaitkan sertifikat atau ID Amazon Cognito dengan benda di registri yang mewakili perangkat Anda, dengan menjalankan perintah. [attach-thing-principal](https://docs.aws.amazon.com//cli/latest/reference/iot/attach-thing-principal.html)
Untuk melampirkan sertifikat atau ID Amazon Cognito ke barang Anda, gunakan perintah: [attach-thing-principal](https://docs.aws.amazon.com//cli/latest/reference/iot/attach-thing-principal.html)
```
$ aws iot attach-thing-principal \
--thing-name "MyLightBulb1" \
--principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847"
```
Untuk melampirkan sertifikat ke barang Anda dengan jenis lampiran (lampiran eksklusif atau lampiran non-eksklusif), gunakan [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-thing-principal.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-thing-principal.html)perintah dan tentukan jenis di `--thing-principal-type` bidang. Lampiran eksklusif berarti IoT Anda adalah satu-satunya hal yang dilampirkan pada sertifikat, dan sertifikat ini tidak dapat dikaitkan dengan hal lain. Lampiran non-eksklusif berarti IoT Anda dilampirkan pada sertifikat, dan sertifikat ini dapat dikaitkan dengan hal-hal lain. Untuk informasi selengkapnya, lihat [Mengaitkan AWS IoT sesuatu dengan koneksi klien MQTT](exclusive-thing.md).
**catatan**
Untuk [Mengaitkan AWS IoT sesuatu dengan koneksi klien MQTT](exclusive-thing.md) fitur ini, Anda hanya dapat menggunakan sertifikat X.509 sebagai prinsipal.
```
$ aws iot attach-thing-principal \
--thing-name "MyLightBulb2" \
--principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847" \
--thing-principal-type "EXCLUSIVE_THING"
```
Jika lampiran berhasil, **AttachThingPrincipal** perintah tidak menghasilkan output apa pun. Untuk menggambarkan lampiran, gunakan list-thing-principals-v 2 perintah CLI.
Untuk informasi selengkapnya, lihat [AttachThingPrincipal](https://docs.aws.amazon.com//iot/latest/apireference/API_AttachThingPrincipal.html)dari *Referensi AWS IoT Core API*.
# Daftar hal-hal yang terkait dengan kepala sekolah
Untuk membuat daftar hal-hal yang terkait dengan prinsipal yang ditentukan, jalankan [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-things.htmls](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-things.htmls)perintah. Perhatikan bahwa perintah ini tidak mencantumkan jenis lampiran antara benda dan sertifikat. Untuk membuat daftar jenis lampiran, gunakan [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-thingsv2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-thingsv2.html)perintah. Untuk informasi selengkapnya, lihat [Buat daftar hal-hal yang terkait dengan prinsipal V2](list-principal-things-v2.md).
```
$ aws iot list-principal-things \
--principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
```
Outputnya bisa terlihat seperti berikut ini.
```
{
"things": [
"MyLightBulb1",
"MyLightBulb2"
]
}
```
Untuk informasi selengkapnya, lihat [ListPrincipalThings](https://docs.aws.amazon.com//iot/latest/apireference/API_ListPrincipalThings.html)dari *Referensi AWS IoT Core API*.
# Daftar kepala sekolah yang terkait dengan suatu hal
Untuk membuat daftar prinsipal yang terkait dengan hal yang ditentukan, jalankan perintah. [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principals.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principals.html) Perhatikan bahwa perintah ini tidak mencantumkan jenis lampiran antara benda dan sertifikat. Untuk membuat daftar jenis lampiran, gunakan [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principalsv2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principalsv2.html)perintah. Untuk informasi selengkapnya, lihat [Daftar kepala sekolah yang terkait dengan sesuatu V2](list-thing-principals-v2.md).
```
$ aws iot list-thing-principals \
--thing-name "MyLightBulb1"
```
Outputnya bisa terlihat seperti berikut ini.
```
{
"principals": [
"arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8",
"arn:aws:iot:us-east-1:123456789012:cert/1a234b39b4b68278f2e9d84bf97eac2cbf4a1c28b23ea29a44559b9bcf8d395b"
]
}
```
Untuk informasi selengkapnya, lihat [ListThingPrincipals](https://docs.aws.amazon.com//iot/latest/apireference/API_ListThingPrincipals.html)dari *Referensi AWS IoT Core API*.
# Buat daftar hal-hal yang terkait dengan prinsipal V2
Untuk membuat daftar hal-hal yang terkait dengan sertifikat yang ditentukan, bersama dengan jenis lampiran, jalankan [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-thingsv2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-thingsv2.html)perintah. Jenis lampiran mengacu pada bagaimana sertifikat dilampirkan pada benda tersebut.
```
$ aws iot list-principal-things-v2 \
--principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
```
Outputnya bisa terlihat seperti berikut ini.
```
{
"PrincipalThingObjects": [
{
"thingPrincipalType": "NON_EXCLUSIVE_THING",
"thing": "arn:aws:iot:us-east-1:123456789012:thing/thing_1"
},
{
"thingPrincipalType": "NON_EXCLUSIVE_THING",
"thing": "arn:aws:iot:us-east-1:123456789012:thing/thing_2"
}
]
}
```
Untuk informasi selengkapnya, lihat [ListPrincipalThingsV2](https://docs.aws.amazon.com//iot/latest/apireference/API_ListPrincipalThingsV2.html) dari *Referensi AWS IoT Core API*.
# Daftar kepala sekolah yang terkait dengan sesuatu V2
Untuk membuat daftar sertifikat yang terkait dengan hal yang ditentukan, bersama dengan jenis lampiran, jalankan [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principalsv2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principalsv2.html)perintah. Jenis lampiran mengacu pada bagaimana sertifikat dilampirkan pada benda tersebut.
```
$ aws iot list-thing-principals-v2 \
--thing-name "thing_1"
```
Outputnya bisa terlihat seperti berikut ini.
```
{
"ThingPrincipalObjects": [
{
"thingPrincipalType": "NON_EXCLUSIVE_THING",
"principal": "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
},
{
"thingPrincipalType": "NON_EXCLUSIVE_THING",
"principal": "arn:aws:iot:us-east-1:123456789012:cert/1a234b39b4b68278f2e9d84bf97eac2cbf4a1c28b23ea29a44559b9bcf8d395b"
}
]
}
```
Untuk informasi selengkapnya, lihat [ListThingsPrincipalV2](https://docs.aws.amazon.com//iot/latest/apireference/API_ListThingPrincipalsV2.html) dari *Referensi AWS IoT Core API*.
# 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/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
```
**DetachThingPrincipal**Perintah tidak menghasilkan output apa pun.
Untuk informasi selengkapnya, lihat [detach-thing-principal](https://docs.aws.amazon.com//iot/latest/apireference/API_DetachThingPrincipal.html)dari *Referensi AWS IoT Core API*.