すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:DeleteDeviceFile

最終更新日:Apr 17, 2025

デバイスから IoT Platform にアップロードされたファイルを削除します。

制限

各 Alibaba Cloud アカウントは、最大 500 クエリ/秒(QPS)を実行できます。

説明 Alibaba Cloud アカウントの RAM ユーザーは、アカウントのクォータを共有します。

デバッグ

Alibaba Cloud は、API の使用を簡素化するために OpenAPI Explorer を提供しています。 OpenAPI Explorer は署名の値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK 用の操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメータータイプ必須説明
ActionStringはいDeleteDeviceFile

実行する操作。値を DeleteDeviceFile に設定します。

FileIdStringはい6UCo1SqbqnQEoh9aK4561****

QueryDeviceFileList 操作を呼び出して、レスポンスでファイル ID を表示できます。

IotInstanceIdStringいいえiot_instc_pu****_c*-v64********

インスタンスの ID です。IoT Platform コンソール の [概要] ページでインスタンスの [ID] を確認できます。

重要
  • インスタンスに ID がある場合は、このパラメーターを設定する必要があります。このパラメーターを設定しないと、呼び出しは失敗します。
  • インスタンスに 概要 ページまたは ID がない場合は、このパラメーターを設定する必要はありません。

詳細については、「概要」をご参照ください。

ProductKeyStringいいえa1BwAGV****

デバイスが属するプロダクトの ProductKey。

説明 このパラメーターを指定する場合は、DeviceName パラメーターも指定する必要があります。
DeviceNameStringいいえlight

デバイスの名前。

説明 このパラメーターを指定する場合は、プロダクトキー パラメーターも指定する必要があります。
IotIdStringいいえQ7uOhVRdZRRlDnTLv****00100

デバイスの ID。ID は、IoT Platform がデバイスに発行する一意の識別子です。

説明 このパラメーターを指定する場合は、プロダクトキー または DeviceName を指定する必要はありません。IotId パラメーターは、プロダクトキーDeviceName の組み合わせに対応する、デバイスのグローバル一意識別子(GUID)を指定します。IotIdプロダクトキーDeviceName の組み合わせの両方を指定した場合、IotId が優先されます。

上記の操作固有のリクエストパラメーターに加えて、この操作を呼び出すときは、共通のリクエストパラメーターを指定する必要があります。詳細については、「共通リクエストパラメーター」をご参照ください。

レスポンスパラメーター

パラメータータイプ説明
CodeStringiot.system.SystemException

呼び出しが失敗した場合に返されるエラーコード。詳細については、「エラーコード」をご参照ください。

ErrorMessageStringシステム例外が発生しました。

呼び出しが失敗した場合に返されるエラーメッセージ。

RequestIdStringE55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

リクエストの ID。

SuccessBooleantrue

呼び出しが成功したかどうかを示します。

  • true: 呼び出しは成功しました。
  • false: 呼び出しは失敗しました。

リクエストの例

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 エラーセンターにアクセスしてください。