デバイスから IoT Platform にアップロードされたファイルを削除します。
制限
各 Alibaba Cloud アカウントは、最大 500 クエリ/秒(QPS)を実行できます。
説明 Alibaba Cloud アカウントの RAM ユーザーは、アカウントのクォータを共有します。
デバッグ
リクエストパラメーター
| パラメーター | タイプ | 必須 | 例 | 説明 |
| Action | String | はい | DeleteDeviceFile | 実行する操作。値を DeleteDeviceFile に設定します。 |
| FileId | String | はい | 6UCo1SqbqnQEoh9aK4561**** | QueryDeviceFileList 操作を呼び出して、レスポンスでファイル ID を表示できます。 |
| IotInstanceId | String | いいえ | iot_instc_pu****_c*-v64******** | インスタンスの ID です。IoT Platform コンソール の [概要] ページでインスタンスの [ID] を確認できます。 重要
詳細については、「概要」をご参照ください。 |
| ProductKey | String | いいえ | a1BwAGV**** | デバイスが属するプロダクトの ProductKey。 説明 このパラメーターを指定する場合は、DeviceName パラメーターも指定する必要があります。 |
| DeviceName | String | いいえ | light | デバイスの名前。 説明 このパラメーターを指定する場合は、プロダクトキー パラメーターも指定する必要があります。 |
| IotId | String | いいえ | Q7uOhVRdZRRlDnTLv****00100 | デバイスの ID。ID は、IoT Platform がデバイスに発行する一意の識別子です。 説明 このパラメーターを指定する場合は、プロダクトキー または DeviceName を指定する必要はありません。IotId パラメーターは、プロダクトキー と DeviceName の組み合わせに対応する、デバイスのグローバル一意識別子(GUID)を指定します。IotId と プロダクトキー と DeviceName の組み合わせの両方を指定した場合、IotId が優先されます。 |
上記の操作固有のリクエストパラメーターに加えて、この操作を呼び出すときは、共通のリクエストパラメーターを指定する必要があります。詳細については、「共通リクエストパラメーター」をご参照ください。
レスポンスパラメーター
| パラメーター | タイプ | 例 | 説明 |
| Code | String | iot.system.SystemException | 呼び出しが失敗した場合に返されるエラーコード。詳細については、「エラーコード」をご参照ください。 |
| ErrorMessage | String | システム例外が発生しました。 | 呼び出しが失敗した場合に返されるエラーメッセージ。 |
| RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | リクエストの ID。 |
| Success | Boolean | true | 呼び出しが成功したかどうかを示します。
|
例
リクエストの例
https://iot.cn-shanghai.aliyuncs.com/?Action=DeleteDeviceFile
&ProductKey=aliYSOl****
&DeviceName=deviceName1
&FileId=6UCo1SqbqnQEoh9aK4561****
&<共通リクエストパラメーター>成功レスポンスの例
XML 形式
<DeleteDeviceFileResponse>
<RequestId>C25255EA-9F6E-4E04-85FE-AC1E9C136EBB</RequestId>
<Success>true</Success>
</DeleteDeviceFileResponse>JSON 形式
{
"RequestId": "C25255EA-9F6E-4E04-85FE-AC1E9C136EBB",
"Success": true
}エラーコード
エラーコードのリストについては、API エラーセンターにアクセスしてください。