QueryDeviceFile API - IoT Platform - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

Sınırlamalar

Alibaba Cloud hesabı başına saniyede en fazla 500 sorgu (QPS) desteklenir.

Not

RAM kullanıcıları hesap kotasını paylaşır.

Hata Ayıklama

OpenAPI Explorer, imzaları otomatik olarak hesaplar ve SDK örnek kodu oluşturur. Bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz.

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	QueryDeviceFile	Gerçekleştirilecek işlem. Değeri QueryDeviceFile olarak ayarlayın.
FileId	String	Evet	xL0G67MBLBDtkR7GCfT	Dosya kimliği. Dosya kimliklerini elde etmek için QueryDeviceFileList API'sini çağırın.
IotInstanceId	String	Hayır	iot_instc_pu*_c-v64	Örnek ID. Bu değeri IoT Platform konsolundaki Overview sayfasında bulabilirsiniz. Önemli Örneğinizin bir ID'si varsa bu parametre zorunludur. Aksi takdirde çağrı başarısız olur. Örneğinizin Overview sayfası veya ID'si yoksa bu parametre gerekli değildir. 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 adı. Not Bu parametreyi belirtirseniz ProductKey parametresini de belirtmeniz gerekir.
IotId	String	Hayır	Q7uOhVRdZRRlDnTLv****00100	IoT Platform tarafından verilen cihaz kimliği. Not IotId, bir ProductKey ve DeviceName kombinasyonuna karşılık gelen bir GUID'dir. Bu parametre belirtilirse ProductKey ve DeviceName parametrelerinin belirtilmesi gerekmez. Hem IotId hem de ProductKey/DeviceName kombinasyonu belirtilirse IotId önceliklidir.

Bu işlemi çağırırken Ortak istek parametrelerini de belirtmeniz gerekir.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
Code	String	iot.system.SystemException	Başarısızlık durumunda döndürülen hata kodu. Hata kodları.
Data	Struct		Başarılı durumda döndürülen dosya bilgileri.
DownloadUrl	String	http://iotx-file-store.oss-cn-shanghai.aliyuncs.com/device_file/A849/aGE/testFile3.txt?Expires=1553162075&OSSAccessKeyId=LTAI&Signature=%2F8	Dosya indirme URL'si.
FileId	String	6UCo1SqbqnQEoh9aKqDQ01****	Dosya kimliği.
Name	String	testFile3.txt	Dosya adı.
Size	String	102400	Dosya boyutu (KB cinsinden).
UtcCreatedOn	String	2019-03-21T08:45:42.000Z	Dosyanın UTC cinsinden oluşturulma zamanı.
ErrorMessage	String	A system exception occurred.	Başarısızlık durumunda döndürülen hata mesajı.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	İstek kimliği.
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

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceFile
&ProductKey=a1BwAGV****
&DeviceName=deviceName1
&FileId=6UCo1SqbqnQEoh9aKqD******
&<Common request parameters>

Örnek yanıt

XML formatı

<QueryDeviceFileResponse>
  <RequestId>93C5276D-5C8A-40D9-BFD6-4BD5B8C1A08F</RequestId>
  <Data>
        <Name>testFile3.txt</Name>
        <DownloadUrl>http://iotx-file-store.oss-cn-shanghai.aliyuncs.com/device_file/A849******/aGE******/testFile3.txt?Expires=1553162075&OSSAccessKeyId=LTAI****************&Signature=%2F8******</DownloadUrl>
        <FileId>6UCo1SqbqnQEoh9aKqDQ01****</FileId>
        <UtcCreatedOn>2019-03-21T08:45:42.000Z</UtcCreatedOn>
        <Size>102400</Size>
  </Data>
  <Success>true</Success>
</QueryDeviceFileResponse>

JSON formatı

{
  "RequestId": "93C5276D-5C8A-40D9-BFD6-4BD5B8C1A08F",
  "Data": {
    "Name": "testFile3.txt",
    "DownloadUrl": "http://iotx-file-store.oss-cn-shanghai.aliyuncs.com/device_file/A849******/aGE******/testFile3.txt?Expires=1553162075&OSSAccessKeyId=LTAI****************&Signature=%2F8******",
    "FileId": "6UCo1SqbqnQEoh9aKqDQ01****",
    "UtcCreatedOn": "2019-03-21T08:45:42.000Z",
    "Size": "102400"
  },
  "Success": true
}

Hata kodları

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