免責事項
このページに掲載されているすべてのコンテンツは、Tuya (HK) Limited によって提供されていることにご注意ください。Alibaba Cloud は、そのようなコンテンツの真正性または正確性について、明示的または黙示的に表明または保証するものではなく、Tuya (HK) Limited が提供する製品および/またはサービスの状態、品質、耐久性、性能、信頼性、商品性、特定の目的への適合性、または権利の非侵害についても一切保証するものではありません。
静的アップグレードバッチを作成します。
リクエストパラメーター
名前 | タイプ | 必須 | サンプル値 | 説明 |
Action | 文字列 | はい | CreateOTAStaticUpgradeJob | システム定義パラメーター。値: CreateOTAStaticUpgradeJob。 |
FirmwareID | 文字列 | はい | 178 | アップグレードパッケージ ID。アップグレードパッケージの一意の識別子です。 |
ProductKey | 文字列 | はい | K1nhvyl * * * * | アップグレード パッケージが属するプロダクトの ProductKey です。 |
TargetSelection | 文字列 | はい | All | アップグレード範囲。 ●すべて：完全アップグレード。 ●特定の ：対象を絞ったアップグレード。 ●段階的：段階的アップグレード。 ●グループ：グループアップグレード。 |
SrcVersion.N | RepeatList | いいえ | V1.0.1 | アップグレード対象のバージョン番号のリスト。 説明 |
RetryInterval | 整数 | いいえ | 60 | デバイスのアップグレードが失敗した後の自動再試行の時間間隔。単位は分です。オプション値: ●0: 直ちに再試行します。 ●10: 10 分後に再試行します。 ●30: 30 分後に再試行します。 ●60: 60 分後 (つまり 1 時間後) に再試行します。 ●1440: 1,440 分後 (つまり 24 時間後) に再試行します。 このパラメーターが指定されていない場合、再試行は行われません。 |
RetryCount | 整数 | いいえ | 1 | 自動再試行回数。 RetryInterval パラメーターを受け取る場合は、このパラメーターを渡す必要があります。 オプション値: ●1: 1 回。 ●2: 2 回。 ●5: 5 回。 |
TimeoutInMinutes | 整数 | いいえ | 1440 | デバイスのアップグレードタイムアウト期間。デバイスがアップグレードを完了しない場合、アップグレードは失敗します。単位は分で、値の範囲は 1 ～ 1,440 です。 このパラメーターが指定されていない場合、デバイスのアップグレードにタイムアウト制限はありません。 |
GrayPercent | 文字列 | いいえ | 33 | グレースケール を設定します。値は文字列形式の整数です。 アップグレード範囲がグレースケール アップグレード ( TargetSelection=GRAY ) として指定されている場合、このパラメーターを渡す必要があります。 |
TargetDeviceName.N | RepeatList | いいえ | DeviceName | 対象となるアップグレードのデバイス名のリスト。 |
NeedPush | ブール値 | いいえ | True | IoT プラットフォームがアップグレード タスクをデバイスにアクティブにプッシュするかどうか。 ●True (デフォルト): はい。バッチ タスクが作成されると、IoT プラットフォームはアップグレード範囲内のオンライン デバイスにアップグレード タスクを直接プッシュします。 この場合でも、デバイスは IoT プラットフォームにリクエストを送信して、OTA アップグレード タスク情報を取得できます。 ●False: いいえ。デバイスは IoT プラットフォームにリクエストを送信して、OTA アップグレード タスク情報を取得する必要があります。 |
NeedConfirm | ブール値 | いいえ | False | デバイスの OTA アップグレードを自律的に制御する必要がある場合は、このパラメーターを設定し、モバイルフォン アプリを使用して、デバイスを OTA でアップグレードできるかどうかを制御できます。モバイル アプリは自分で開発する必要があります。 ●False (デフォルト): いいえ。 NeedPush 設定に従って OTA アップグレード タスク情報を直接取得します。 ●True: はい。デバイスは OTA アップグレード タスクを取得できません。アプリ側で OTA アップグレードを確認してから、NeedPush 設定に従って OTA アップグレード タスク情報を取得する必要があります。 |
GroupID | 文字列 | いいえ | CtjzCkNuOx *** | グループ ID。 グループ アップグレード ( TargetSelection=GROUP ) タスクを開始する場合にのみ、このパラメーターを渡す必要があります。 |
DownloadProtocol | 文字列 | いいえ | Https | アップグレード パッケージのダウンロード プロトコル。現在利用可能なのは Https のみです。IoT プラットフォームによってプッシュされたアップグレード パッケージのダウンロード情報を受信した後、デバイスはこのプロトコルを介してアップグレード パッケージをダウンロードします。 |
N注: API を呼び出すときは、このトピックで説明されている API 固有のリクエスト パラメーターに加えて、共通リクエスト パラメーターも渡す必要があります。共通リクエスト パラメーターの詳細については、「共通パラメーター」をご参照ください。
戻りデータ
名前 | タイプ | サンプル値 | 説明 |
Code | 文字列 | Iot.system.SystemException | 呼び出しが失敗した場合に返されるエラーコード。詳細については、「エラーコード」をご参照ください。 |
Data | 構造体 | 呼び出しが成功した場合に返されるアップグレード バッチ情報。詳細については、Data パラメーターの説明をご参照ください。 | |
JobID | 文字列 | 183634077921266 * * * * | アップグレード バッチ ID。アップグレード バッチの一意の識別子です。 |
UtcCreate | 文字列 | 2024-11-11 T11:21:54.607Z | アップグレード バッチの作成時刻 (UTC 形式)。 |
ErrorMessage | 文字列 | System Exception | 呼び出しが失敗した場合に返されるエラー情報。 |
RequestID | 文字列 | Kan | IoT プラットフォームがリクエストに対して生成する一意の識別子。 |
Success | ブール値 | True | 呼び出しが成功したかどうか。 ●True: 呼び出しは成功です。OTA アップグレード パッケージが正常に作成されたことを示します。 ●False: 呼び出しは失敗です。OTA アップグレード パッケージの作成に失敗したことを示します。 |
例
リクエスト例
curl 'https://si-d6e8d812acb848958054.tuyacloud.com:8686/?Action=CreateOTAStaticUpgradeJob&SignatureNonce=9e6189124f5a4716ad2de849467b****&AccessKeyId=xMr9wgwXQLhv5AUa65o0****&SignatureMethod=HMAC-SHA1&Timestamp=2024-11-19T09%3A47%3A43Z&FirmwareId=167&ProductKey=k1nhvyl****&TargetSelection=ALL&RetryCount=1&RetryInterval=60&TimeoutInMinutes=1440&SrcVersion.1=1.0&Signature=WJN0Ee8%2BX6pogcD3loLHIqQNEN0%3D'正常な戻り値の例
{
"code": "",
"data": {
"firmwareId": "183634077921266****",
"utcCreate": "2024-11-20T08:50:00.239Z"
},
"requestId": "d2fce065-8238-4ee2-a793-0226f69b0542",
"success": true
}