

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Bekerja dengan AWS IoT di AWS Toolkit for Visual Studio Code
<a name="iot-start"></a>

AWS IoT in AWS Toolkit for Visual Studio Code memungkinkan Anda untuk berinteraksi dengan AWS IoT layanan, sambil meminimalkan gangguan pada alur kerja Anda di VS Code. Panduan pengguna ini dimaksudkan untuk membantu Anda mulai menggunakan fitur AWS IoT layanan yang tersedia di AWS Toolkit for Visual Studio Code. Untuk informasi tambahan tentang AWS IoT layanan, lihat panduan pengembang [Apa itu AWS IoT?](https://docs.aws.amazon.com/iot/latest/developerguide/what-is-aws-iot.html)

## AWS IoT prasyarat
<a name="iot-vsctoolkit-prereq"></a>

Untuk AWS IoT mulai menggunakan Toolkit for VS Code, pastikan akun dan VS Code AWS Anda memenuhi persyaratan dalam panduan ini:
+ Untuk persyaratan AWS akun dan izin AWS pengguna khusus untuk AWS IoT layanan, lihat panduan [Memulai dengan pengembang AWS IoT Inti](https://docs.aws.amazon.com/iot/latest/developerguide/setting-up.html).
+ Untuk persyaratan khusus Toolkit for VS Code, lihat panduan pengguna [Menyiapkan Toolkit for](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/setting-up.html) VS Code.

## AWS IoT Hal-hal
<a name="iot-vsctoolkit-things"></a>

AWS IoT menghubungkan perangkat ke layanan AWS cloud dan sumber daya. Anda dapat menghubungkan perangkat Anda AWS IoT dengan menggunakan objek yang disebut **benda**. Sesuatu adalah representasi dari perangkat tertentu atau entitas logis. Ini bisa berupa perangkat fisik atau sensor (misalnya, bola lampu atau sakelar di dinding). Untuk informasi tambahan tentang AWS IoT berbagai hal, lihat panduan pengembang [Mengelola perangkat dengan AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-thing-management.html). 

### Mengelola AWS IoT hal-hal
<a name="iot-vsctoolkit-things-actions"></a>

Toolkit for VS Code memiliki beberapa fitur yang membuat manajemen barang AWS IoT Anda lebih efisien. Ini adalah cara Anda dapat menggunakan toolkit VS Code untuk mengelola AWS IoT barang-barang Anda: 
+ [Create a thing](#thing-create)
+ [Attach a certificate to a thing](#thing-certificate-attach)
+ [Detach a certificate from a thing](#thing-certificate-detach)
+ [Delete a thing](#thing-delete)<a name="thing-create"></a>

**Untuk menciptakan sesuatu**

1. **Dari AWS Explorer, perluas judul layanan **IoT**, dan pilih konteks (klik kanan) Things.**

1. Pilih **Create Thing** dari menu konteks untuk membuka kotak dialog.

1. Ikuti prompt dengan memasukkan nama untuk hal IoT Anda ke dalam bidang **Thing Name**.

1. Ketika ini selesai, **ikon benda** yang diikuti dengan nama yang Anda tentukan akan terlihat di bagian **Thing**.<a name="thing-certificate-attach"></a>

**Untuk melampirkan sertifikat pada suatu hal**

1. Dari AWS Explorer, perluas bagian layanan **IoT**.

1. Di bawah subbagian **Things**, temukan **hal** di mana Anda melampirkan sertifikat. 

1. Pilih konteks (klik kanan) **benda** itu dan pilih **Lampirkan Sertifikat** dari menu konteks, untuk membuka pemilih input dengan daftar sertifikat Anda.

1. Dari daftar, pilih **ID sertifikat** yang sesuai dengan sertifikat yang ingin Anda lampirkan ke barang Anda.

1. Ketika ini selesai, sertifikat Anda dapat diakses di AWS explorer, sebagai item dari benda yang Anda lampirkan.<a name="thing-certificate-detach"></a>

**Untuk melepaskan sertifikat dari suatu hal**

1. Dari AWS Explorer, perluas bagian **layanan IoT**

1. Di subbagian **Things**, temukan **hal** yang ingin Anda lepaskan sertifikatnya. 

1. Pilih konteks (klik kanan) **benda** itu dan pilih **Lepaskan** Sertifikat dari menu konteks.

1. Ketika ini selesai, sertifikat terpisah tidak akan lagi ditampilkan di bawah benda itu di AWS Explorer, tetapi masih dapat diakses dari subbagian **Sertifikat**.<a name="thing-delete"></a>

**Untuk menghapus sesuatu**

1. Dari AWS Explorer, perluas bagian layanan **IoT**.

1. Di subbagian **Things**, cari **hal** yang ingin Anda hapus.

1. Konteks-pilih (klik kanan) benda itu dan pilih **Delete Thing dari menu konteks untuk menghapusnya**.

1. Ketika ini selesai, hal yang dihapus tidak akan lagi tersedia dari subbagian **Things**.
**catatan**  
Catatan: Anda hanya dapat menghapus sesuatu yang tidak memiliki sertifikat yang dilampirkan padanya.

## AWS IoT sertifikat
<a name="iot-vsctoolkit-cert"></a>

Sertifikat adalah cara umum untuk membuat koneksi aman antara AWS IoT layanan dan perangkat Anda. Sertifikat X.509 adalah sertifikat digital yang menggunakan standar infrastruktur kunci publik X.509 untuk mengaitkan kunci publik dengan identitas yang terkandung dalam sertifikat. Untuk informasi tambahan tentang AWS IoT sertifikat, lihat panduan pengembang [Otentikasi (IoT)](https://docs.aws.amazon.com/iot/latest/developerguide/authentication.html).

### Mengelola sertifikat
<a name="iot-vsctoolkit-cert-actions"></a>

Toolkit VS Code menawarkan berbagai cara bagi Anda untuk mengelola AWS IoT sertifikat Anda, langsung dari AWS Explorer. 
+ [Create a certificate](#cert-create)
+ [Change a certificate status](#cert-status)
+ [Attach a policy to a certificate](#cert-attach-policy)
+ [Delete a certificate](#cert-delete)<a name="cert-create"></a>

**Untuk membuat AWS IoT sertifikat**

Sertifikat X.509 dapat digunakan untuk terhubung dengan instance Anda. AWS IoT

1. **Dari AWS Explorer, perluas bagian layanan **IoT**, dan pilih konteks (klik kanan) Sertifikat.**

1. Pilih **Buat Sertifikat** dari menu konteks untuk membuka kotak dialog.

1. Pilih direktori di sistem file lokal Anda untuk menyimpan key pair RSA dan sertifikat X.509 Anda.
**catatan**  
Nama file default berisi ID sertifikat sebagai awalan.
Hanya sertifikat X.509 yang disimpan dengan AWS akun Anda, melalui layanan. AWS IoT 
Key pair RSA Anda hanya dapat diterbitkan sekali, menyimpannya ke lokasi yang aman di sistem file Anda saat Anda diminta.
Jika sertifikat atau key pair tidak dapat disimpan ke sistem file Anda saat ini, maka AWS Toolkit menghapus sertifikat dari akun Anda AWS .<a name="cert-status"></a>

**Untuk mengubah status sertifikat**

Status sertifikat individu ditampilkan di sebelah ID-nya di AWS Explorer dan dapat diatur ke: aktif, tidak aktif, atau dicabut.
**catatan**  
Sertifikat Anda memerlukan status **aktif** sebelum Anda dapat menggunakannya untuk menghubungkan perangkat ke AWS IoT layanan Anda.
Sertifikat yang **tidak aktif** dapat diaktifkan, apakah telah dinonaktifkan sebelumnya atau tidak aktif secara default.
Sertifikat yang telah **dicabut** tidak dapat diaktifkan kembali.

1. Dari AWS Explorer, perluas bagian layanan **IoT**.

1. Di sub-bagian **Sertifikat**, cari sertifikat yang ingin Anda ubah.

1. Pilih konteks (klik kanan) sertifikat untuk membuka menu konteks yang menampilkan opsi perubahan status yang tersedia untuk sertifikat tersebut.
+ Jika sertifikat memiliki status **tidak aktif**, pilih **aktifkan** untuk mengubah status menjadi **aktif**.
+ Jika sertifikat memiliki status **aktif**, pilih **nonaktifkan** untuk mengubah status menjadi **tidak** aktif.
+ **Jika sertifikat memiliki status **aktif atau **tidak aktif****, pilih cabut untuk mengubah status yang **dicabut**.**

**catatan**  
Masing-masing tindakan perubahan status ini juga tersedia jika Anda memilih sertifikat yang dilampirkan pada suatu benda saat ditampilkan di subbagian **Things**.<a name="cert-attach-policy"></a>

**Untuk melampirkan kebijakan IoT ke sertifikat**

1. Dari AWS Explorer, perluas bagian layanan **IoT**.

1. Di sub-bagian **Sertifikat**, cari sertifikat yang ingin Anda ubah.

1. Pilih konteks (klik kanan) sertifikat dan pilih **Lampirkan Kebijakan** dari menu konteks, untuk membuka pemilih input dengan daftar kebijakan yang tersedia.

1. Pilih kebijakan yang ingin Anda lampirkan ke sertifikat.

1. Ketika ini selesai, kebijakan yang Anda pilih akan ditambahkan ke sertifikat sebagai item sub-menu.<a name="cert-detach-policy"></a>

**Untuk melepaskan kebijakan IoT dari sertifikat**

1. Dari AWS Explorer, perluas bagian layanan **IoT**.

1. Di sub-bagian **Sertifikat**, cari sertifikat yang ingin Anda ubah.

1. Perluas sertifikat dan temukan kebijakan yang ingin Anda lepaskan.

1. Pilih konteks (klik kanan) kebijakan dan pilih **Lepaskan** dari menu konteks.

1. Ketika ini selesai, kebijakan tidak akan lagi menjadi item yang dapat diakses dari sertifikat Anda, tetapi akan tersedia dari sub-bagian **Kebijakan**.<a name="cert-delete"></a>

**Untuk menghapus sertifikat**

1. Dari AWS Explorer, perluas judul layanan **IoT**.

1. Di sub-bagian **Sertifikat**, cari sertifikat yang ingin Anda hapus.

1. Konteks-pilih (klik kanan) sertifikat dan pilih **Hapus Sertifikat** dari menu konteks.
**catatan**  
Anda tidak dapat menghapus sertifikat jika terlampir pada suatu benda atau memiliki status aktif. Anda dapat menghapus sertifikat yang memiliki kebijakan terlampir.

## AWS IoT kebijakan
<a name="iot-vsctoolkit-policy"></a>

AWS IoT Kebijakan inti didefinisikan melalui dokumen JSON, masing-masing berisi satu atau lebih pernyataan kebijakan. Kebijakan menentukan cara AWS IoT AWS, dan perangkat Anda dapat berinteraksi satu sama lain. Untuk informasi selengkapnya tentang cara membuat dokumen kebijakan, lihat panduan pengembang Kebijakan [IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html).

**catatan**  
Kebijakan bernama diberi versi sehingga Anda dapat memutarnya kembali. Di The AWS Explorer, kebijakan IoT Anda tercantum di bawah subbagian **Kebijakan**, di layanan IoT. Anda dapat melihat versi kebijakan dengan memperluas kebijakan. Versi default dilambangkan dengan tanda bintang.

### Mengelola kebijakan
<a name="iot-vsctoolkit-policy-actions"></a>

Toolkit for VS Code menawarkan beberapa cara bagi Anda untuk mengelola kebijakan layanan AWS IoT Anda. Ini adalah cara Anda dapat mengelola atau mengubah kebijakan Anda langsung dari AWS Explorer di VS Code: 
+ [Create a policy](#policy-create)
+ [Upload a new policy version](#policy-version-upload)
+ [Edit a policy version](#policy-version-edit)
+ [Change the policy version defualt](#policy-version-default)
+ [Change the policy version defualt](#policy-delete)<a name="policy-create"></a>

**Untuk membuat AWS IoT kebijakan**
**catatan**  
Anda dapat membuat kebijakan baru dari AWS Explorer, tetapi dokumen JSON yang mendefinisikan kebijakan harus sudah ada di sistem file Anda.

1. Dari AWS Explorer, perluas bagian layanan **IoT**.

1. **Pilih konteks (klik kanan) subbagian **Kebijakan** dan pilih **Buat Kebijakan dari Dokumen**, untuk membuka kolom input Nama Kebijakan.**

1. Masukkan nama dan ikuti petunjuk untuk membuka dialog yang meminta Anda memilih dokumen JSON dari sistem file Anda.

1. Pilih file JSON yang berisi definisi kebijakan Anda, kebijakan akan tersedia di AWS explorer saat ini selesai.<a name="policy-version-upload"></a>

**Untuk mengunggah versi AWS IoT kebijakan baru**

Versi baru kebijakan dapat dibuat dengan mengunggah dokumen JSON ke kebijakan.
**catatan**  
Dokumen JSON baru harus ada di sistem file Anda untuk membuat versi baru menggunakan AWS Explorer.

1. Dari AWS Explorer, perluas bagian layanan **IoT**.

1.  Perluas subbagian **Kebijakan** untuk melihat kebijakan Anda AWS IoT 

1. Pilih konteks (klik kanan) kebijakan yang ingin Anda perbarui dan pilih **Buat versi baru** dari Dokumen.

1. Saat dialog terbuka, pilih file JSON yang berisi pembaruan definisi kebijakan Anda.

1. Versi baru akan dapat diakses dari kebijakan Anda di AWS Explorer.<a name="policy-version-edit"></a>

**Untuk mengedit versi AWS IoT kebijakan**

Dokumen kebijakan dapat dibuka dan diedit menggunakan Kode VS. Setelah selesai mengedit dokumen, Anda dapat menyimpannya ke sistem file Anda. Kemudian, Anda dapat mengunggahnya ke AWS IoT layanan Anda dari AWS Explorer.

1. Dari AWS Explorer, perluas bagian layanan **IoT**.

1. Perluas subbagian **Kebijakan** dan temukan kebijakan yang ingin Anda perbarui. **Buat Kebijakan dari Dokumen** untuk membuka kolom input **Nama Kebijakan**.

1. Perluas kebijakan yang ingin Anda perbarui, lalu pilih Konteks (klik kanan) versi kebijakan yang ingin Anda edit.

1. Pilih **Lihat** dari menu konteks untuk membuka versi kebijakan di VS Code

1. Saat dokumen kebijakan dibuka, buat dan simpan perubahan yang Anda inginkan.
**catatan**  
Pada titik ini, perubahan yang Anda buat pada kebijakan hanya disimpan ke sistem file lokal Anda. Untuk memperbarui versi dan melacaknya dengan AWS Explorer, ulangi langkah-langkah yang dijelaskan dalam [Upload a new policy version](#policy-version-upload) prosedur.<a name="policy-version-default"></a>

**Untuk memilih default versi kebijakan baru**

1. Dari AWS Explorer, perluas bagian layanan **IoT**.

1. Perluas subbagian **Kebijakan** dan temukan kebijakan yang ingin Anda perbarui.

1. **Perluas kebijakan yang ingin Anda perbarui, lalu pilih Konteks (klik kanan) versi kebijakan yang ingin disetel, lalu pilih Setel sebagai Default.**

1. Ketika ini selesai, versi default baru yang Anda pilih akan memiliki bintang yang terletak di sebelahnya.<a name="policy-delete"></a>

**Untuk menghapus kebijakan**
**catatan**  
Sebelum Anda dapat menghapus kebijakan atau versi kebijakan, ada kondisi yang harus dipenuhi.  
Anda tidak dapat menghapus kebijakan jika dilampirkan ke sertifikat.
Anda tidak dapat menghapus kebijakan jika memiliki versi non-default.
Anda tidak dapat menghapus versi default kebijakan kecuali versi default baru dipilih, atau seluruh kebijakan dihapus.
Sebelum Anda dapat menghapus seluruh kebijakan, semua versi non-default kebijakan tersebut harus dihapus terlebih dahulu.

1. Dari AWS Explorer, perluas bagian layanan **IoT**.

1. Perluas subbagian **Kebijakan** dan temukan kebijakan yang ingin Anda perbarui.

1. **Perluas kebijakan yang ingin Anda perbarui, lalu pilih Konteks (klik kanan) versi kebijakan yang ingin dihapus, lalu pilih Hapus.**

1. Ketika versi dihapus, itu tidak akan lagi terlihat dari Explorer.

1. Jika satu-satunya versi yang tersisa untuk kebijakan adalah default, Anda dapat memilih konteks (klik kanan) kebijakan induk dan memilih **Hapus untuk menghapusnya**.