Tüm Ürünler
Search
Belge Merkezi

IoT Platform:Etiketler

Son Güncelleme:Oct 03, 2026

Ortak özelliklere sahip kaynakları kategorize etmek için ürünlere, cihazlara ve gruplara özel etiketler atayın. Etiketler, IoT kaynaklarının geniş ölçekte aranmasını, toplanmasını ve yönetilmesini kolaylaştırır.

Kullanım notları


Etiket


Açıklama


ürün etiketi

Aynı ürün altındaki tüm cihazların paylaştığı nitelikleri tanımlar.

Örneğin, bir ürünün üreticisini, bağlı olduğu organizasyonu, fiziksel boyutlarını veya işletim sistemini belirlemek için etiketleri kullanabilirsiniz.


cihaz etiketi

Bir cihazı belirli bir özelliğine göre tanımlayarak cihazları kategorize etmenizi, toplamanızı ve analiz ederek tek bir yerden yönetmenizi sağlar.

Örneğin, 201 numaralı odadaki akıllı sayaç için room:201 etiketini atayabilirsiniz.


grup etiketi

Bir gruptaki cihazların ve alt grupların paylaştığı nitelikleri tanımlayarak ürünler arası cihaz yönetimini mümkün kılar.

Örneğin, bir gruptaki cihazların bulunduğu bölgeyi veya alanı etiketleyebilirsiniz.

Kullanım senaryoları

Etiketleri kullanarak toplu işlemler gerçekleştirin

Etiket

Örnek işlem

ürün etiketi

Bir IoT Platform örneğinde, ortak niteliklere sahip ürünleri etiketlerine göre bulun.

cihaz etiketi

Hedef cihazları etiketlerine göre aradıktan sonra aşağıdaki toplu işlemleri gerçekleştirebilirsiniz:

  • Cihazları etkinleştirin, devre dışı bırakın veya silin. Daha fazla bilgi için bkz. Cihazları devre dışı bırakma ve etkinleştirme ve Cihaz silme.

  • Cihaz gruplarını yönetirken veya cihaz OTA güncellemeleri yaparken Gelişmiş Arama özelliğini kullanarak cihazları belirli etiketlere göre hızlıca filtreleyebilir ve hedef gruba veya OTA güncelleme görevine ekleyebilirsiniz. Daha fazla bilgi için bkz. Gelişmiş arama.

grup etiketi

Bir IoT Platform örneğinde, ortak niteliklere sahip grupları ve alt grupları etiketlerine göre bulun.

Cihazlardan etiketleri yönetin

Cihazlarınızda etiket yönetimini uyguladıktan sonra cihazlar aşağıdaki işlemleri gerçekleştirebilir:

  • Etiketleri bildir: Bir cihaz etiketlerini bildirdiğinde, IoT Platform konsoldaki ilgili cihaz etiketlerini otomatik olarak ekler veya günceller.

  • Etiketleri sil: Bir cihaz etiketlerini silmek için istek gönderir ve IoT Platform bu isteği aldığında etiketleri kaldırır.

  • Etiketleri sorgula: Bir cihaz etiketlerini sorgulamak için istek gönderir ve IoT Platform bu isteği aldığında talep edilen bilgileri döndürür.

IoT Platform'un çok dilli cihaz tarafı Link SDK'sı etiketleme özelliğini entegre eder ve etiket bilgilerini sistem içinde iletir. Cihaz tarafı Link SDK kod örnekleri için bkz. Cihaz geliştirme için cihaz etiketleri. Etiketleri yönetmek için kullanılan konu başlıkları ve veri biçimleri hakkında bilgi edinmek için bkz. Cihaz etiketleri için Alink protokolü.

Etiket değişikliği bilgilerini iletin

Mesaj yönlendirme sayesinde IoT Platform, cihaz etiketi işlemlerine (ekleme, güncelleme, silme ve temizleme) ilişkin mesajları uygulama sunucunuza veya diğer Alibaba Cloud hizmetlerine gönderir. Mesaj yönlendirmeyi yapılandırma hakkında daha fazla bilgi için bkz. Mesaj yönlendirme. İletilen veri biçimi hakkında bilgi edinmek için bkz. Cihaz etiketi değişiklikleri.

Ön koşullar

  1. IoT Platform konsolu üzerinde oturum açtınız.

  2. Etiket eklemeden önce ilgili ürünü, cihazı veya grubu oluşturun. Daha fazla bilgi için aşağıdaki konulara bakın:

Arka plan bilgisi

Çok sayıda IoT cihazını yönetmek genellikle bunları ayırt etmeyi ve toplu olarak işlemeyi gerektirir. IoT Platform, bu ihtiyaca etiketleme özelliği ile yanıt verir. Ürünlere, cihazlara ve gruplara etiketler atayın ve ardından bu etiketlere göre sınıflandırıp yönetin.

Sınırlamalar

  • Ürün, cihaz ve grup etiketleri, Key:Value biçiminde anahtar-değer çiftleridir.

  • abc etiket anahtarı IoT Platform tarafından ayrılmıştır. Bir etiketin Key değerini abc olarak ayarlamayın. Key=abc şeklinde ayarlarsanız, etiket tabanlı aramalar sırasında bu etiket otomatik olarak filtreden çıkarılır.

  • Etiket anahtarları büyük/küçük harfe duyarlı değildir. Ancak IoT Platform ve mesaj yönlendirme özelliği kullanılarak iletilen veriler, etiket key değerinin orijinal büyük/küçük harf durumunu her zaman korur.

    Bir etiketi silip yalnızca büyük/küçük harf değişikliği yaparak yeniden ekleseniz bile, iletilen verilerdeki key değeri orijinal büyük/küçük harf durumunu korur.

    Örneğin, ssid:1000 etiketini oluşturup daha sonra Ssid:1001 kullanarak güncellerseniz Value değeri başarıyla 1001 olarak güncellenir ancak sistem tarafından iletilen veriler hâlâ ssid:1001 biçimini kullanır.

  • Her ürün, cihaz veya grup en fazla 100 etikete sahip olabilir.

Konsolda etiketleri düzenleyin

Ürün etiketlerini düzenleyin

  1. Overview sayfasında yönetmek istediğiniz örneği bulun ve örnek kimliğine veya örnek adına tıklayın.

  2. Sol gezinme bölmesinde Devices > Product öğelerini seçin.

  3. Products sayfasında etiketlemek istediğiniz ürünü bulun ve ilgili İşlemler sütunundaki View seçeneğine tıklayın.

    Tag Information bölümü ürünün tüm etiketlerini görüntüler.

  4. Tag Information bölümünün sağ tarafındaki Edit seçeneğine tıklayın.

  5. Edit Tag iletişim kutusunda Tag Key ve Tag Value değerlerini girin.

    Mevcut bir etiketi kaldırmak için Delete seçeneğine tıklayın veya yeni bir etiket eklemek için + Add Tag seçeneğine tıklayın.


    Parametre


    Açıklama


    tag key


    1 ila 30 karakter uzunluğunda olmalı ve harf, rakam ile nokta (.) içerebilir.


    tag value


    En fazla 128 karakter uzunluğunda olmalı ve Çince karakterler, Japonca karakterler, harfler, rakamlar, alt çizgi (_), kısa çizgi (-), iki nokta üst üste (:) ve nokta (.) içerebilir. Her Çince veya Japonca karakter iki karakter olarak sayılır.

  6. (İsteğe bağlı) Daha fazla etiket eklemek için Add Tag seçeneğine tıklayın veya istenmeyen etiketleri kaldırmak için Delete seçeneğine tıklayın.

  7. Confirm seçeneğine tıklayın.

Cihaz etiketlerini düzenleyin

  1. Hedef örneğin sol gezinme bölmesinde Devices > Device öğelerini seçin.

  2. Device sayfasında etiketlemek istediğiniz cihaz için View seçeneğine tıklayın.

    Tag Information bölümü cihazın tüm etiketlerini görüntüler.

  3. Device Details sayfasında Tag Information bölümünün sağ tarafındaki Edit seçeneğine tıklayın.

  4. Edit Tag iletişim kutusunda Add Tag seçeneğine tıklayın ve tag key ile tag value değerlerini girin.


    Parametre


    Açıklama


    tag key


    1 ila 30 karakter uzunluğunda olmalı ve harf, rakam, eğik çizgi (/), alt çizgi (_), kısa çizgi (-), diyez (#), at işareti (@), yüzde işareti (%), ampersan (&), yıldız (*) ve nokta (.) içerebilir.


    tag value


    En fazla 128 karakter uzunluğunda olmalı ve Çince karakterler, Japonca karakterler, harfler, rakamlar, alt çizgi (_), kısa çizgi (-), diyez (#), at işareti (@), yüzde işareti (%), ampersan (&), iki nokta üst üste (:) ve nokta (.) içerebilir. Her Çince veya Japonca karakter iki karakter olarak sayılır.

  5. (İsteğe bağlı) Daha fazla etiket eklemek için Add Tag seçeneğine tıklayın veya istenmeyen etiketleri kaldırmak için Delete seçeneğine tıklayın.

  6. Confirm seçeneğine tıklayın.

Grup etiketlerini düzenleyin

  1. Hedef örneğin sol gezinme bölmesinde Devices > Group öğelerini seçin.

  2. Groups sayfasında etiket eklemek istediğiniz grubu bulun ve ilgili İşlemler sütunundaki View seçeneğine tıklayın.

    Group Tags bölümü grubun tüm etiketlerini görüntüler.

  3. Tag Information bölümünün sağ tarafındaki Edit seçeneğine tıklayın.

  4. Edit Tag iletişim kutusunda Tag Key ve Tag Value değerlerini girin.

    Mevcut bir etiketi kaldırmak için Delete seçeneğine tıklayın veya yeni bir etiket eklemek için + Add Tag seçeneğine tıklayın.


    Parametre


    Açıklama


    tag key


    1 ila 30 karakter uzunluğunda olmalı ve harf, rakam ile nokta (.) içerebilir.


    tag value


    En fazla 128 karakter uzunluğunda olmalı ve Çince karakterler, Japonca karakterler, harfler, rakamlar, alt çizgi (_), kısa çizgi (-), iki nokta üst üste (:) ve nokta (.) içerebilir. Her Çince veya Japonca karakter iki karakter olarak sayılır.

  5. (İsteğe bağlı) Daha fazla etiket eklemek için Add Tag seçeneğine tıklayın veya istenmeyen etiketleri kaldırmak için Delete seçeneğine tıklayın.

  6. OK seçeneğine tıklayın.

Sunucu tarafı API'ler ile etiketleri yönetin

IoT Platform, etiketleri toplu olarak yönetmek ve ürünleri, cihazları ve grupları etiketlerine göre sorgulamak için sunucu tarafı API'ler sağlar.

Ürün etiketleri

Özellik

API

Açıklama

Etiketleri düzenle

CreateProductTags

Ürün etiketleri oluşturur.

UpdateProductTags

Ürün etiketlerini günceller.

DeleteProductTags

Ürün etiketlerini siler.

Etiketleri sorgula

ListProductTags

Bir ürünün tüm etiketlerini sorgular.

Etiketleri kullan

ListProductByTags

Ürünleri etikete göre sorgular.

Cihaz etiketleri

Özellik

API

Açıklama

Etiketleri düzenle

SaveDeviceProp

Cihaz etiketlerini ayarlar.

DeleteDeviceProp

Cihaz etiketlerini siler.

Etiketleri sorgula

QueryDeviceProp

Belirtilen bir cihazın etiket listesini sorgular.

Etiketleri kullan

QueryDeviceByTags

Cihazları etikete göre sorgular.

Grup etiketleri


Özellik


API


Açıklama


Etiketleri düzenle


SetDeviceGroupTags


Grup etiketleri ekler, günceller veya siler.


Etiketleri sorgula


QueryDeviceGroupTagList


Bir grubun etiket listesini sorgular.


Etiketleri kullan


QueryDeviceGroupByTags


Cihaz gruplarını etikete göre sorgular.