QueryDeviceGroupByTags - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

Cihaz gruplarını etikete göre sorgular.

Sınırlamalar

Her Alibaba Cloud hesabı saniyede en fazla 5 sorgu (QPS) çalıştırabilir.

Not

Bir Alibaba Cloud hesabının RAM kullanıcıları, hesabın kotasını paylaşır.

Hata Ayıklama

Alibaba Cloud, API kullanımını kolaylaştırmak için OpenAPI Explorer sağlar. OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için örnek kodu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	QueryDeviceGroupByTags	Gerçekleştirmek istediğiniz işlem. Değeri QueryDeviceGroupByTags olarak ayarlayın.
Tag.N.TagKey	String	Evet	group	Her bir etiketin anahtarı.
Tag.N.TagValue	String	Evet	tag	Etiketin değeri.
IotInstanceId	String	Hayır	iot_instc_pu***_c-v64********	Örneğin ID'si. IoT Platform konsolunda Overview sayfasında örnek ID'sini görüntüleyebilirsiniz. Önemli Örneğinizin bir ID'si varsa bu parametreyi yapılandırmanız gerekir. Bu parametreyi ayarlamazsanız çağrı başarısız olur. Örneğinizin Overview sayfası veya ID'si yoksa bu parametreyi ayarlamanız gerekmez. Daha fazla bilgi için bkz. Overview.
CurrentPage	Integer	Hayır	1	Döndürülecek sayfanın numarası. Varsayılan değer: 1.
PageSize	Integer	Hayır	10	Her sayfada döndürülecek girdi sayısı. Varsayılan değer: 10.

Yukarıdaki işleme özel istek parametrelerine ek olarak, bu işlemi çağırırken ortak istek parametrelerini de belirtmeniz gerekir. Daha fazla bilgi için bkz. Ortak istek parametreleri.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
Code	String	iot.system.SystemException	Çağrı başarısız olursa döndürülen hata kodu. Daha fazla bilgi için bkz. Hata kodları.
Data	Array of DeviceGroup		Çağrı başarılı olursa döndürülen grup bilgileri.
DeviceGroup
GroupId	String	Z0ElGF5aqc0t****	Grubun ID'si.
GroupName	String	test11	Grubun adı.
ErrorMessage	String	A system exception occurred.	Çağrı başarısız olursa döndürülen hata mesajı.
Page	Integer	1	Döndürülen sayfanın numarası.
PageCount	Integer	1	Toplam sayfa sayısı.
PageSize	Integer	10	Her sayfada döndürülen girdi sayısı.
RequestId	String	9599EE98-1642-4FCD-BFC4-039E458A4693	İsteğin ID'si.
Success	Boolean	true	Çağrının başarılı olup olmadığını gösterir. true: Çağrı başarılı oldu. false: Çağrı başarısız oldu.
Total	Integer	1	Toplam kayıt sayısı.

Örnekler

Örnek istekler

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceGroupByTags
&Tag.1.TagKey=group
&Tag.1.TagValue=tag
&CurrentPage=1
&PageSize=10
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

<QueryDeviceGroupByTagsResponse> 
    <PageCount>1</PageCount>  
    <Data> 
        <DeviceGroup> 
            <GroupName>test11</GroupName>  
            <GroupId>Z0ElGF5aqc0t****</GroupId> 
        </DeviceGroup> 
    </Data>  
    <Page>1</Page>  
    <PageSize>10</PageSize>  
    <RequestId>9599EE98-1642-4FCD-BFC4-039E458A4693</RequestId>  
    <Success>true</Success>  
    <Total>1</Total> 
</QueryDeviceGroupByTagsResponse>

JSON biçimi

{
    "PageCount": 1, 
    "Data": {
        "DeviceGroup": [
            {
                "GroupName": "test11", 
                "GroupId": "Z0ElGF5aqc0t****"
            }
        ]
    }, 
    "Page": 1, 
    "PageSize": 10, 
    "RequestId": "9599EE98-1642-4FCD-BFC4-039E458A4693", 
    "Success": true, 
    "Total": 1
}

Hata kodları

Hata kodlarının listesi için API Error Center adresini ziyaret edin.