IoT Platform に直接接続されているデバイスの一意の証明書ごとのプロダクト登録ステータスをリセットするか、デバイスの現在のトポロジを削除します。
使用上の注意
- ダイナミック登録を使用して、直接接続されたデバイスのデバイス証明書情報を取得し、デバイスをアクティブ化した後、この操作を呼び出して、IoT Platform コンソールでステータスのダイナミック登録ステータスを未登録にリセットできます。その後、ダイナミック登録を再度使用して、デバイス証明書情報を取得できます。デバイス証明書情報には、ProductKey、DeviceName、および DeviceSecret が含まれます。説明 この操作は、デバイスのアクティベーションステータスではなく、ダイナミック登録ステータスをリセットするために呼び出されます。デバイスのダイナミック登録ステータスをリセットする操作を呼び出した後、IoT Platform コンソールでのデバイスのステータスは非アクティブにはリセットされません。
- ゲートウェイを指定し、そのゲートウェイに属するサブデバイスの数が 2,000 を超える場合は、この操作を呼び出して、非同期でトポロジ関係を削除するデバイスタスクを作成できます。この操作は、JobId パラメーターを返します。
QPS 制限
各 Alibaba Cloud アカウントは、最大 500 クエリ/秒（QPS）を実行できます。
説明 Alibaba Cloud アカウントの RAM ユーザーは、Alibaba Cloud アカウントのクォータを共有します。
デバッグ
リクエストパラメーター
| パラメーター | タイプ | 必須 | 例 | 説明 |
| Action | String | Yes | ResetThing | 実行する操作。値を ResetThing に設定します。 |
| IotInstanceId | String | No | iot-cn-0pp1n8t**** | インスタンスの ID。IoT Platform コンソールの 概要 ページでインスタンスの ID を表示できます。 重要
詳細については、「インスタンスの概要」をご参照ください。 |
| ProductKey | String | No | a1KiV****** | デバイスが属するプロダクトの ProductKey。 説明 このパラメーターに値を指定する場合は、DeviceName パラメーターにも値を指定する必要があります。 |
| DeviceName | String | No | device1 | デバイスの DeviceName。 説明 このパラメーターに値を指定する場合は、ProductKey パラメーターにも値を指定する必要があります。 |
| IotId | String | No | SR8FiTu1R9tlUR2V1bmi0010a5**** | デバイスの ID。 説明 このパラメーターに値を指定する場合は、ProductKey パラメーターまたは DeviceName パラメーターに値を指定する必要はありません。IotId パラメーターは、デバイスのグローバル一意識別子（GUID）を指定します。 IotId パラメーターの値は、ProductKey パラメーターと DeviceName パラメーターの値の組み合わせに対応します。IotId パラメーターに値を指定し、ProductKey パラメーターと DeviceName パラメーターにも値を指定した場合、IotId パラメーターの値が優先されます。 |
上記の操作固有のリクエストパラメーターに加えて、この操作を呼び出すときは、共通のリクエストパラメーターを指定する必要があります。詳細については、「共通リクエストパラメーター」をご参照ください。
レスポンスパラメーター
| パラメーター | タイプ | 例 | 説明 |
| Code | String | iot.system.SystemException | 呼び出しが失敗した場合に返されるエラーコード。詳細については、「エラーコード」をご参照ください。 |
| ErrorMessage | String | A system exception occurred. | 呼び出しが失敗した場合に返されるエラーメッセージ。 |
| JobId | String | 450407b*** | デバイスタスクの ID。 |
| RequestId | String | 57b144cf-09fc-4916-a272-a62902d5b207 | リクエストの ID。 |
| Success | Boolean | true | 呼び出しが成功したかどうかを示します。有効な値：true は、呼び出しが成功したことを示します。false は、呼び出しが失敗したことを示します。 |
例
リクエストの例
https://iot.cn-shanghai.aliyuncs.com/?Action=ResetThing
&IotId=MpEKNuEUJzIORNANAWJX0010929900*****
&<共通リクエストパラメーター>成功レスポンスの例
XML 形式
<ResetThingResponse>
<RequestId>57b144cf-09fc-4916-a272-a62902d5b207</RequestId>
<Success>true</Success>
</ResetThingResponse>JSON 形式
{
"RequestId":"57b144cf-09fc-4916-a272-a62902d5b207",
"Success": true
}エラーコード
エラーコードのリストについては、API エラーセンター をご確認ください。