QueryDeviceOriginalEventData - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

Belirtilen bir cihaz tarafından gönderilen olay kayıtlarını sorgular. Bu kayıtlar, belirtilen Thing Specification Language (TSL) modeli tarafından doğrulanan ve doğrulanmayan olayları içerir.

Sınırlamalar

Yalnızca son 30 gün içinde oluşturulan olay kayıtlarını sorgulayabilirsiniz.

Not

Bir olay kaydının depolama süresi, kaydın oluşturulduğu günden itibaren hesaplanır.

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

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

Hata Ayıklama

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 işlem örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	QueryDeviceOriginalEventData	Gerçekleştirmek istediğiniz işlem. Değeri QueryDeviceOriginalEventData olarak ayarlayın.
Asc	Integer	Evet	0	Döndürülen olay kayıtlarının sıralama düzeni. Olası değerler: 0: azalan. 1: artan.
EndTime	Long	Evet	1516541900303	Sorgulanacak zaman aralığının bitişi. Değer, milisaniye cinsinden 13 basamaklı bir zaman damgasıdır.
Identifier	String	Evet	PowerOff	Sorgulamak istediğiniz olay tanımlayıcısı. Düşük düzeyde doğrulama uygulanıyorsa, bir cihaz olayının Identifier değerini görüntülemek için aşağıdaki adımları izleyebilirsiniz: IoT Platform konsoluna giriş yapın ve Ürün Ayrıntıları sayfasındaki Özellik Tanımla sekmesine gidin. Ayrıca QueryThingModel işlemini çağırarak döndürülen TSL verilerindeki hizmet tanımlayıcısını görüntüleyebilirsiniz. Doğrulama uygulanmıyorsa, değer cihaz tarafından gönderilen özel tanımlayıcı değeriyle aynı olmalıdır.
PageSize	Integer	Evet	10	Her sayfada döndürülecek giriş sayısı. Geçerli değerler: 1 ila 50. Varsayılan değer: 10.
StartTime	Long	Evet	1516538300303	Sorgulanacak zaman aralığının başlangıcı. Değer, milisaniye cinsinden 13 basamaklı bir zaman damgasıdır.
IotInstanceId	String	Hayır	iot_instc_pu***_c-v64********	Örneğin ID'si. Örnek ID değerini IoT Platform konsolundaki Overview sayfasında 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 bir Overview sayfası veya ID'si yoksa bu parametreyi ayarlamanız gerekmez. Daha fazla bilgi için bkz. Overview.
ProductKey	String	Hayır	a1BwAGV****	Cihazın ait olduğu ürünün ProductKey değeri. Not Bu parametreyi belirtirseniz DeviceName parametresini de belirtmeniz gerekir.
DeviceName	String	Hayır	light	Cihazın adı. Not Bu parametreyi belirtirseniz ProductKey parametresini de belirtmeniz gerekir.
NextPageToken	String	Hayır	Bo***x44Qx	Sonraki sayfanın tanımlayıcısı. Sonraki sayfa varsa bu parametre döndürülür. Bu durumda, parametrenin değerini bir sonraki isteğe eklemeniz gerekir.
IotId	String	Hayır	Q7uOhVRdZRRlDnTLv****00100	Cihazın ID'si. IoT Platform tarafından cihaz için oluşturulan benzersiz tanımlayıcıdır. Not Bu parametreyi belirtirseniz ProductKey veya DeviceName parametresini belirtmenize gerek yoktur. IotId parametresi cihaz için benzersiz bir tanımlayıcı belirtir ve ProductKey ile DeviceName parametrelerinin birleşimine karşılık gelir. IotId parametresi ile ProductKey ve DeviceName parametrelerinin birleşimini aynı anda belirtirseniz yalnızca IotId parametresi kullanılır.

Yukarıdaki işleme özgü istek parametrelerine ek olarak, bu API işlemini çağırırken ortak istek parametrelerini de belirtmeniz gerekir. Ortak istek parametreleri hakkında daha fazla bilgi için bkz. Ortak parametreler.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
Code	String	iot.device.InvalidIoTId	Çağrı başarısız olursa döndürülen hata kodu. Daha fazla bilgi için bkz. Hata kodları.
Data	Struct		Çağrı başarılı olursa döndürülen olay kayıtları.
List	Array of EventInfo		Olay dizisi. Her öğe bir olayı temsil eder. Olayla ilgili ayrıntılar için EventInfo parametresinin parametrelerine bakın.
EventInfo
EventType	String	info	Olay türü. Geçerli değerler: info: bilgi. alert: uyarı. error: hata.
Identifier	String	PowerOff	Olayın tanımlayıcısı.
Name	String	Device shutdown	Olayın adı.
OutputData	String	{"structArgs":{"structchildFLOATf71c20e":1.23}}	Olayın çıkış parametresi. Değer, MAP formatında bir dizedir.
Time	String	1579163099000	Olayın gerçekleştiği zaman. Değer, milisaniye cinsinden 13 basamaklı bir zaman damgasıdır.
NextPageToken	String	Bo***x44Qx	Sonraki sayfanın tanımlayıcısı.
NextValid	Boolean	true	Sonraki sayfanın var olup olmadığını gösterir. true: Sonraki sayfa vardır. false: Sonraki sayfa yoktur. Değer true olarak döndürülürse, geçerli sorguda yer almayan verileri sorgulamak için NextPageToken parametresinin değerini bir sonraki isteğe ekleyebilirsiniz.
ErrorMessage	String	A system exception has occurred.	Çağrı başarısız olursa döndürülen hata mesajı.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	İ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.

Örnekler

Örnek istekler

http(s)://iot.cn-shanghai.aliyuncs.com/? Action=QueryDeviceOriginalEventData
&Asc=0
&EndTime=1516541900303
&Identifier=PowerOff
&PageSize=10
&StartTime=1516538300303
&<Common request parameters>

Örnek başarılı yanıtlar

XML formatı

<QueryDeviceOriginalEventDataResponse>
  <Data>
        <NextValid>false</NextValid>
        <NextTime>Bo***x44Qx</NextTime>
        <List>
              <EventInfo>
                    <Name>testEventInfoName</Name>
                    <Time>1516517974638</Time>
                    <OutputData>{"structArgs":{"structchildFLOATf71c20e":1.23,"structchildINT6b6b626":3,"structchildDATE663436a":"1516517966152","structchildDOUBLE08d0f74":1.23,"structchildTEXTdc764f9":"07b68264b0ba42c18e5f","structchildBOOLd260729":0,"structchildENUMbe62590":1},"enumArgs":0,"boolArgs":0,"floatArgs":2.3,"dateArgs":"1516517966152","intArgs":1,"doubleArgs":2.3,"textArgs":"dV56zbkzjBjw1Ti1dA52"}</OutputData>
                    <EventType>info</EventType>
                    <Identifier>testEventInfo</Identifier>
              </EventInfo>
        </List>
  </Data>
  <RequestId>45391E10-446B-4986-863E-1BA8CC44748F</RequestId>
  <Success>true</Success>
</QueryDeviceOriginalEventDataResponse>

JSON formatı

{
  "Data": {
    "NextValid": false, 
    "NextPageToken": "Bo***x44Qx", 
    "List": {
      "EventInfo": [
        {
          "Name": "testEventInfoName", 
          "Time": 1516517974638, 
          "OutputData": "{\"structArgs\":{\"structchildFLOATf71c20e\":1.23,\"structchildINT6b6b626\":3,\"structchildDATE663436a\":\"1516517966152\",\"structchildDOUBLE08d0f74\":1.23,\"structchildTEXTdc764f9\":\"07b68264b0ba42c18e5f\",\"structchildBOOLd260729\":0,\"structchildENUMbe62590\":1},\"enumArgs\":0,\"boolArgs\":0,\"floatArgs\":2.3,\"dateArgs\":\"1516517966152\",\"intArgs\":1,\"doubleArgs\":2.3,\"textArgs\":\"dV56zbkzjBjw1Ti1dA52\"}", 
          "EventType": "info", 
          "Identifier": "testEventInfo"
        }
      ]
    }
  }, 
  "RequestId": "45391E10-446B-4986-863E-1BA8CC44748F", 
  "Success": true
}

Hata kodları

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