All Products
Search

This Product

    IoT Platform:Tag

    Document Center

    IoT Platform:Tag

    Last Updated:Jun 16, 2026

    Tetapkan tag kustom ke produk, perangkat, dan kelompok untuk mengkategorikan sumber daya yang memiliki karakteristik bersama. Tag menyederhanakan pencarian, agregasi, dan pengelolaan sumber daya IoT dalam skala besar.

    Catatan penggunaan

    Tag

    Deskripsi

    product tag

    Menjelaskan atribut yang dimiliki oleh semua perangkat dalam satu produk yang sama.

    Sebagai contoh, Anda dapat menggunakan tag untuk mengidentifikasi produsen produk, organisasi, dimensi fisik, atau sistem operasi.

    device tag

    Mengidentifikasi perangkat berdasarkan karakteristik tertentu, sehingga memungkinkan Anda mengkategorikan, mengagregasi, dan menganalisis perangkat untuk pengelolaan terpadu.

    Sebagai contoh, Anda dapat menetapkan tag room:201 ke smart meter di Ruang 201.

    group tag

    Menjelaskan atribut yang dimiliki oleh perangkat dan subkelompok dalam suatu kelompok, sehingga memungkinkan pengelolaan perangkat lintas produk.

    Sebagai contoh, Anda dapat memberi tag wilayah atau ruang tempat perangkat dalam suatu kelompok berada.

    Kasus penggunaan

    Lakukan operasi batch menggunakan tag

    Tag

    Contoh operasi

    product tag

    Temukan produk yang memiliki atribut umum dalam instans IoT Platform berdasarkan tag-nya.

    device tag

    Setelah mencari perangkat target berdasarkan tag-nya, Anda dapat melakukan operasi batch berikut:

    • Aktifkan, nonaktifkan, atau hapus perangkat. Untuk informasi selengkapnya, lihat Nonaktifkan dan aktifkan perangkat dan Hapus perangkat.

    • Saat mengelola kelompok perangkat atau melakukan pembaruan OTA perangkat, Anda dapat menggunakan fitur Pencarian Lanjutan untuk memfilter perangkat berdasarkan tag tertentu dan menambahkannya ke kelompok target atau tugas pembaruan OTA. Untuk informasi selengkapnya, lihat Pencarian lanjutan.

    group tag

    Temukan kelompok dan subkelompok yang memiliki atribut umum dalam instans IoT Platform berdasarkan tag-nya.

    Kelola tag dari perangkat

    Setelah menerapkan manajemen tag pada perangkat Anda, perangkat tersebut dapat melakukan operasi berikut:

    • Laporkan tag: Saat perangkat melaporkan tag-nya, IoT Platform secara otomatis menambahkan atau memperbarui tag perangkat yang sesuai di Konsol.

    • Hapus tag: Perangkat mengirim permintaan untuk menghapus tag-nya, dan IoT Platform menghapusnya setelah menerima permintaan tersebut.

    • Kueri tag: Perangkat mengirim permintaan untuk menanyakan tag-nya, dan IoT Platform mengembalikan informasi yang diminta setelah menerima permintaan tersebut.

    Link SDK multibahasa IoT Platform di sisi perangkat telah mengintegrasikan fitur tagging dan mentransmisikan informasi tag dalam sistem. Untuk contoh kode Link SDK di sisi perangkat, lihat Tag perangkat untuk pengembangan perangkat. Untuk topik dan format data yang digunakan untuk mengelola tag, lihat Protokol Alink untuk tag perangkat.

    Teruskan informasi perubahan tag

    Dengan penerusan pesan, IoT Platform mengirim pesan tentang operasi tag perangkat (tambah, perbarui, hapus, dan kosongkan) ke server aplikasi Anda atau layanan Alibaba Cloud lainnya. Untuk informasi lebih lanjut tentang konfigurasi penerusan pesan, lihat Penerusan pesan. Untuk format data yang diteruskan, lihat Perubahan tag perangkat.

    Prasyarat

    1. Anda telah masuk ke Konsol IoT Platform.

    2. Sebelum menambahkan tag, buat produk, perangkat, atau kelompok yang sesuai terlebih dahulu. Untuk informasi selengkapnya, lihat topik berikut:

    Informasi latar belakang

    Mengelola banyak perangkat IoT sering kali memerlukan pembedaan dan pemrosesan batch. IoT Platform mengatasi hal ini dengan fitur tagging-nya. Tetapkan tag ke produk, perangkat, dan kelompok, lalu kategorikan dan kelola berdasarkan tag tersebut.

    Batasan

    • Tag untuk produk, perangkat, dan kelompok merupakan pasangan kunci-nilai dalam format Key:Value.

    • Kunci tag abc dicadangkan oleh IoT Platform. Jangan tetapkan Key tag ke abc. Jika Anda menetapkan Key=abc, tag tersebut akan secara otomatis difilter saat pencarian berbasis tag.

    • Kunci tag tidak peka huruf besar/kecil. Namun, IoT Platform dan data yang diteruskan menggunakan fitur penerusan pesan selalu menggunakan penulisan asli kunci tag key.

      Bahkan jika Anda menghapus tag lalu menambahkannya kembali hanya dengan perubahan kapitalisasi, key dalam data yang diteruskan tetap menggunakan penulisan aslinya.

      Sebagai contoh, jika Anda membuat tag ssid:1000 lalu memperbaruinya menjadi Ssid:1001, Value-nya berhasil diperbarui menjadi 1001, tetapi data yang diteruskan sistem tetap menggunakan ssid:1001.

    • Setiap produk, perangkat, atau kelompok dapat memiliki maksimal 100 tag.

    Edit tag di Konsol

    Edit tag produk

    1. Di halaman Overview, temukan instans yang ingin Anda kelola lalu klik ID instans atau nama instans tersebut.

    2. Di bilah navigasi kiri, pilih Devices > Product.

    3. Di halaman Products, temukan produk yang ingin Anda beri tag, lalu klik View di kolom Actions yang sesuai.

      Bagian Tag Information menampilkan semua tag untuk produk tersebut.

    4. Klik Edit di sebelah kanan Tag Information.

    5. Di kotak dialog Edit Tag, masukkan Tag Key dan Tag Value.

      Klik Delete untuk menghapus tag yang ada, atau klik + Add Tag untuk menambahkan tag baru.

      Parameter

      Deskripsi

      tag key

      Panjangnya harus 1 hingga 30 karakter dan dapat berisi huruf, angka, serta titik (.).

      tag value

      Panjangnya maksimal 128 karakter dan dapat berisi karakter Tionghoa, Jepang, huruf, angka, garis bawah (_), tanda hubung (-), titik dua (:), dan titik (.). Setiap karakter Tionghoa atau Jepang dihitung sebagai dua karakter.

    6. (Opsional) Klik Add Tag untuk menambahkan lebih banyak tag, atau klik Delete untuk menghapus tag yang tidak diinginkan.

    7. Klik Confirm.

    Edit tag perangkat

    1. Di bilah navigasi kiri instans target, pilih Devices > Device.

    2. Di halaman Device, klik View untuk perangkat yang ingin Anda beri tag.

      Bagian Tag Information menampilkan semua tag untuk perangkat tersebut.

    3. Di halaman Device Details, klik Edit di sebelah kanan Tag Information.

    4. Di kotak dialog Edit Tag, klik Add Tag lalu masukkan tag key dan tag value.

      设备标签Kotak dialog ini mencakup dua jenis tag: geographical location tag dan device tags kustom. Untuk geographical location tag, kuncinya adalah coordinate dan nilainya dipilih dari daftar drop-down. Anda dapat mengklik Reset untuk mengembalikan nilai default. Untuk tag perangkat kustom, Anda dapat menentukan pasangan kunci-nilai, seperti room dan 101, lalu mengklik Delete untuk menghapus tag tersebut.

      Parameter

      Deskripsi

      tag key

      Panjangnya harus 1 hingga 30 karakter dan dapat berisi huruf, angka, garis miring (/), garis bawah (_), tanda hubung (-), tanda pagar (#), simbol @, persen (%), ampersand (&), tanda bintang (*), dan titik (.).

      tag value

      Panjangnya maksimal 128 karakter dan dapat berisi karakter Tionghoa, Jepang, huruf, angka, garis bawah (_), tanda hubung (-), tanda pagar (#), simbol @, persen (%), ampersand (&), titik dua (:), dan titik (.). Setiap karakter Tionghoa atau Jepang dihitung sebagai dua karakter.

    5. (Opsional) Klik Add Tag untuk menambahkan lebih banyak tag, atau klik Delete untuk menghapus tag yang tidak diinginkan.

    6. Klik Confirm.

    Edit tag kelompok

    1. Di bilah navigasi kiri instans target, pilih Devices > Group.

    2. Di halaman Groups, temukan kelompok yang ingin Anda beri tag, lalu klik View di kolom Actions yang sesuai.

      Bagian Group Tags menampilkan semua tag untuk kelompok tersebut.

    3. Klik Edit di sebelah kanan Tag Information.

    4. Di kotak dialog Edit Tag, masukkan Tag Key dan Tag Value.

      Klik Delete untuk menghapus tag yang ada, atau klik + Add Tag untuk menambahkan tag baru.

      Parameter

      Deskripsi

      tag key

      Panjangnya harus 1 hingga 30 karakter dan dapat berisi huruf, angka, serta titik (.).

      tag value

      Panjangnya maksimal 128 karakter dan dapat berisi karakter Tionghoa, Jepang, huruf, angka, garis bawah (_), tanda hubung (-), titik dua (:), dan titik (.). Setiap karakter Tionghoa atau Jepang dihitung sebagai dua karakter.

    5. (Opsional) Klik Add Tag untuk menambahkan lebih banyak tag, atau klik Delete untuk menghapus tag yang tidak diinginkan.

    6. Klik OK.

    Kelola tag dengan API sisi server

    IoT Platform menyediakan API sisi server untuk mengelola tag secara batch serta menanyakan produk, perangkat, dan kelompok berdasarkan tag-nya.

    Tag produk

    Fitur

    API

    Deskripsi

    Edit tag

    CreateProductTags

    Membuat tag produk.

    UpdateProductTags

    Memperbarui tag produk.

    DeleteProductTags

    Menghapus tag produk.

    Kueri tag

    ListProductTags

    Menanyakan semua tag suatu produk.

    Gunakan tag

    ListProductByTags

    Menanyakan produk berdasarkan tag.

    Tag perangkat

    Fitur

    API

    Deskripsi

    Edit tag

    SaveDeviceProp

    Menetapkan tag perangkat.

    DeleteDeviceProp

    Menghapus tag perangkat.

    Kueri tag

    QueryDeviceProp

    Menanyakan daftar tag perangkat tertentu.

    Gunakan tag

    QueryDeviceByTags

    Menanyakan perangkat berdasarkan tag.

    Tag kelompok

    Fitur

    API

    Deskripsi

    Edit tag

    SetDeviceGroupTags

    Menambahkan, memperbarui, atau menghapus tag kelompok.

    Kueri tag

    QueryDeviceGroupTagList

    Menanyakan daftar tag suatu kelompok.

    Gunakan tag

    QueryDeviceGroupByTags

    Menanyakan kelompok perangkat berdasarkan tag.