API QueryDeviceFile - IoT Platform - IoT Platform - Centre de documentation Alibaba Cloud

Limites

Maximum de 500 QPS par compte Alibaba Cloud.

Remarque

Les utilisateurs RAM partagent le quota du compte.

Débogage

OpenAPI Explorer calcule automatiquement les signatures et génère des exemples de code SDK. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer.

Paramètres de la requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	QueryDeviceFile	Opération à effectuer. Définissez la valeur sur QueryDeviceFile.
FileId	String	Oui	xL0G67MBLBDtkR7GCfT	ID du fichier. Appelez QueryDeviceFileList pour obtenir les ID de fichier.
IotInstanceId	String	Non	iot_instc_pu*_c-v64	ID de l'instance. Retrouvez-le sur la page Aperçu de la console IoT Platform. Important Obligatoire si votre instance possède un ID. L'appel échoue sans cet élément. Non requis si votre instance ne possède pas de page Aperçu ou d'ID. Aperçu.
ProductKey	String	Non	a1BwAGV****	ProductKey du produit auquel appartient l'appareil. Remarque Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre DeviceName.
DeviceName	String	Non	light	Nom de l'appareil. Remarque Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre ProductKey.
IotId	String	Non	Q7uOhVRdZRRlDnTLv****00100	ID de l'appareil, délivré par IoT Platform. Remarque IotId est un GUID qui correspond à une combinaison ProductKey et DeviceName. S'il est spécifié, les paramètres ProductKey et DeviceName ne sont pas requis. Si vous spécifiez à la fois IotId et la combinaison ProductKey/DeviceName, IotId est prioritaire.

Vous devez également spécifier les paramètres de requête communs lors de l'appel de cette opération.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	iot.system.SystemException	Code d'erreur renvoyé en cas d'échec. Consultez les codes d'erreur.
Data	Struct		Informations sur le fichier renvoyées en cas de succès.
DownloadUrl	String	http://iotx-file-store.oss-cn-shanghai.aliyuncs.com/device_file/A849/aGE/testFile3.txt?Expires=1553162075&OSSAccessKeyId=LTAI&Signature=%2F8	URL de téléchargement du fichier.
FileId	String	6UCo1SqbqnQEoh9aKqDQ01****	ID du fichier.
Name	String	testFile3.txt	Nom du fichier.
Size	String	102400	Taille du fichier en Ko.
UtcCreatedOn	String	2019-03-21T08:45:42.000Z	Heure de création du fichier au format UTC.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemple de requête

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

Exemples de réponses

Format XML

<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>

Format JSON

{
  "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
}

Codes d'erreur

Consultez le Centre d'erreurs d'API pour obtenir la liste des codes d'erreur.