免責事項
このページに掲載されているすべてのコンテンツは、Tuya (HK) Limited によって提供されていることにご注意ください。Alibaba Cloud は、そのようなコンテンツの真正性または正確性について、明示的または黙示的に表明または保証するものではなく、Tuya (HK) Limited が提供する製品および/またはサービスの状態、品質、耐久性、性能、信頼性、商品性、特定の目的への適合性、または権利の非侵害についても一切保証するものではありません。
デバイスの OTA アップグレードパッケージを作成します。
リクエストパラメーター
名前 | タイプ | 必須 | サンプル値 | 説明 |
Action | String | はい | CreateOTAFirmware | システム定義パラメーター。値：CreateOTAFirmware。 |
DestVersion | String | はい | 2.0.0 | OTA アップグレードパッケージのバージョン。文字、数字、ピリオド（.）、ダッシュ（-）、アンダースコア（_）のみがサポートされています。長さは 1 ～ 64 文字に制限されています。 |
FirmwareName | String | はい | Firmware2 | OTA アップグレードパッケージの名前。作成後は変更できません。日本語、中国語、英語、数字、ダッシュ（-）、アンダースコア（_）、半角括弧（）がサポートされています。日本語、中国語、英語、または数字で始める必要があります。長さは 1 ～ 40 文字に制限されています。 |
FirmwareUrl | String | いいえ | Https://oss-612ba0f1-2e08-4adb-9606-78390169****.oss-cn-hangzhou.aliyuncs.com/ota/firmware/bd65da39-cf24-4d9c-b306-6ac14ff5****.bin | OTA アップグレードパッケージファイルの URL。つまり、オブジェクトストレージ（OSS）上のアップグレードパッケージファイルのストレージの場所です。GenerateOTAUploadURL を呼び出して、アップグレードパッケージファイルの URL を生成できます。 |
FirmwareSign | String | いいえ | 93230 * * * * | OTA アップグレードパッケージファイルの署名値。 値（ または ）アップグレードパッケージファイルの内容に署名することで計算された値を使用します。 署名方式値 ( SHA256または MD5) アップグレードパッケージファイルの内容に署名して計算された値です。 |
SignMethod | String | いいえ | Md5 | OTA アップグレードパッケージの署名方式。値: ●Md5 (デフォルト): MD5 署名。 ●Sha256: SHA256 署名。 |
FirmwareSize | Integer | いいえ | 900 | OTA アップグレードパッケージファイルのサイズ。単位：バイト。 |
ProductKey | String | いいえ | A1uctKe * * * * | OTA アップグレードパッケージが属するプロダクトの ProductKey です。 |
FirmwareDesc | String | いいえ | Ota 関数が更新されました | OTA アップグレードパッケージの説明。長さは 100 文字を超えることはできません。1 つの漢字は 1 文字としてカウントされます。 |
Type | Integer | いいえ | 0 | OTA アップグレードパッケージの種類。 ●0 : 完全パッケージアップグレードパッケージ。アップロードしたアップグレードパッケージファイルには、完全なアップグレードパッケージが含まれています。完全パッケージアップグレードパッケージは、アップグレードのためにデバイスにプッシュされます。 差分パッケージアップグレードは今後サポートされる予定です。 |
SrcVersion | String | いいえ | 1.0.0 | アップグレード対象の OTA モジュールのバージョン番号。アップグレード対象デバイスの現在の OTA モジュールのバージョン番号です。 |
ModuleName | String | いいえ | WifiConfigModify | OTA モジュール名。OTA モジュールは、同じプロダクトのデバイスの異なるアップグレード可能なモジュールです。 |
NeedToVerify | Boolean | いいえ | True | バッチアップグレードタスクを作成する前に、アップグレードパッケージの検証に合格する必要があるかどうか。 ●True (デフォルト): 必須 ●False: 不要 |
Udi | String | いいえ | {"Ota_notice":"ぼやけたビデオ画像の問題を解決するために、基盤となるカメラドライバーをアップグレードします。"} | デバイスにプッシュされるカスタム情報。テキストコンテンツの形式に制限はなく、長さは 4096 文字を超えることはできません。 アップグレードパッケージが追加され、アップグレードタスクが作成されると、IoT Platform は、アップグレード通知をデバイスにプッシュするときに、カスタム情報をデバイスに送信します。 |
注：API を呼び出すときは、このトピックで説明されている API 固有のリクエストパラメーターに加えて、共通のリクエストパラメーターも渡す必要があります。共通リクエストパラメーターの詳細については、「」をご参照ください。共通パラメーター。
戻りデータ
名前 | タイプ | サンプル値 | 説明 |
Code | String | Iot.system.SystemException | 呼び出しが失敗した場合に返されるエラーコードです。詳細については、「エラーコード」をご参照ください。 |
Data | Struct | 呼び出しが成功した場合に返されるアップグレードパッケージ情報。詳細については、 パラメーターの説明をご参照ください。 データパラメーターの説明。 | |
FirmwareID | String | Next * * * * | OTA アップグレードパッケージ ID。IoT Platform がアップグレードパッケージに発行する一意の識別子。 |
UtcCreate | String | 2024-11-11 T11:21:54.607Z | OTA アップグレードパッケージの作成時刻（UTC 形式）。 |
ErrorMessage | String | System Exception | 呼び出しが失敗した場合に返されるエラー情報。 |
RequestID | String | Kan | IoT Platform がリクエストに対して生成する一意の識別子。 |
Success | Boolean | True | 呼び出しが成功したかどうか。 ●True : 呼び出しは成功です。OTA アップグレードパッケージが正常に作成されたことを示します。 ●False : 呼び出しは失敗です。OTA アップグレードパッケージの作成に失敗したことを示します。 |
例
リクエスト例
curl 'https://si-d6e8d812acb848958054.tuyacloud.com:8686/?Action=CreateOTAFirmware&SignatureNonce=9e6189124f5a4716ad2de849467b****&AccessKeyId=xMr9wgwXQLhv5AUa65o0****&SignatureMethod=HMAC-SHA1&Timestamp=2024-11-19T09%3A47%3A43Z&ProductKey=a1uctKe****&FirmwareName=Firmware2&DestVersion=1.9.9&FirmwareUrl=https%3A%2F%2Foss-612ba0f1-2e08-4adb-9606-78390169%2A%2A%2A%2A.oss-cn-hangzhou.aliyuncs.com%2Fota%2Ffirmware%2Fbd65da39-cf24-4d9c-b306-6ac14ff5%2A%2A%2A%2A.bin&SignMethod=MD5&FirmwareSign=93230c3bde425a9d7984a594ac55****&FirmwareSize=900&FirmwareDesc=createfirmware&Type=0&ModuleName=ble&Signature=WJN0Ee8%2BX6pogcD3loLHIqQNEN0%3D'通常の 戻り値の例
{
"code": "",
"data": {
"firmwareId": "143",
"utcCreate": "2024-11-20T08:50:00.239Z"
},
"requestId": "d2fce065-8238-4ee2-a793-0226f69b0542",
"success": true
}