DeleteDeviceFile - IoT Platform - Centre de documentation Alibaba Cloud

Supprime un fichier téléchargé depuis un appareil vers IoT Platform.

Limites

Chaque compte Alibaba Cloud peut exécuter jusqu'à 500 requêtes par seconde (QPS).

Remarque

Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota de ce compte.

Débogage

Alibaba Cloud met à votre disposition OpenAPI Explorer pour simplifier l'utilisation des API. OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer pour plus de commodité. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DeleteDeviceFile	Opération à effectuer. Définissez la valeur sur DeleteDeviceFile.
FileId	String	Oui	6UCo1SqbqnQEoh9aK4561****	ID du fichier. Appelez l'opération QueryDeviceFileList et consultez l'ID du fichier dans la réponse.
IotInstanceId	String	Non	iot_instc_pu***_c-v64********	ID de l'instance. Vous pouvez afficher l'ID de l'instance sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez configurer ce paramètre. Sinon, l'appel échouera. Si votre instance ne dispose pas de page Overview ou d'ID, vous n'avez pas besoin de définir ce paramètre. Pour en savoir plus, consultez la rubrique Overview.
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. Il s'agit d'un identifiant unique attribué par IoT Platform à l'appareil. Remarque Si vous spécifiez ce paramètre, il est inutile de spécifier les paramètres ProductKey et DeviceName. Le paramètre IotId correspond à un identifiant global unique (GUID) de l'appareil, qui équivaut à la combinaison des paramètres ProductKey et DeviceName. Si vous spécifiez à la fois le paramètre IotId et la combinaison des paramètres ProductKey et DeviceName, le paramètre IotId est prioritaire.

En plus des paramètres de requête spécifiques à l'opération ci-dessus, vous devez spécifier les paramètres de requête communs lors de l'appel de cette opération. Pour en savoir plus, consultez la rubrique Paramètres de requête communs.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	iot.system.SystemException	Code d'erreur renvoyé en cas d'échec de l'appel. Pour en savoir plus, consultez la rubrique Codes d'erreur.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec de l'appel.
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=DeleteDeviceFile
&ProductKey=aliYSOl****
&DeviceName=deviceName1
&FileId=6UCo1SqbqnQEoh9aK4561****
&<Common request parameters>

Exemple de réponse en cas de succès

XML format

<DeleteDeviceFileResponse>
  <RequestId>C25255EA-9F6E-4E04-85FE-AC1E9C136EBB</RequestId>
  <Success>true</Success>
</DeleteDeviceFileResponse>

JSON format

{
    "RequestId": "C25255EA-9F6E-4E04-85FE-AC1E9C136EBB",
    "Success": true
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.