すべてのプロダクト
Search

このプロダクト

    IoT Platform:ResetThing

    ドキュメントセンター

    IoT Platform:ResetThing

    最終更新日:Apr 17, 2025

    IoT Platform に直接接続されているデバイスの一意の証明書ごとのプロダクト登録ステータスをリセットするか、デバイスの現在のトポロジを削除します。

    使用上の注意

    • ダイナミック登録を使用して、直接接続されたデバイスのデバイス証明書情報を取得し、デバイスをアクティブ化した後、この操作を呼び出して、IoT Platform コンソールでステータスのダイナミック登録ステータスを未登録にリセットできます。その後、ダイナミック登録を再度使用して、デバイス証明書情報を取得できます。デバイス証明書情報には、ProductKey、DeviceName、および DeviceSecret が含まれます。
      説明 この操作は、デバイスのアクティベーションステータスではなく、ダイナミック登録ステータスをリセットするために呼び出されます。デバイスのダイナミック登録ステータスをリセットする操作を呼び出した後、IoT Platform コンソールでのデバイスのステータスは非アクティブにはリセットされません。
    • ゲートウェイを指定し、そのゲートウェイに属するサブデバイスの数が 2,000 を超える場合は、この操作を呼び出して、非同期でトポロジ関係を削除するデバイスタスクを作成できます。この操作は、JobId パラメーターを返します。

    QPS 制限

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

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

    デバッグ

    OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

    リクエストパラメーター

    パラメーター タイプ 必須 例 説明
    Action String Yes ResetThing

    実行する操作。値を ResetThing に設定します。
    IotInstanceId String No iot-cn-0pp1n8t****

    インスタンスの ID。IoT Platform コンソールの 概要 ページでインスタンスの ID を表示できます。

    重要
    • インスタンスに ID がある場合は、このパラメーターに ID を指定する必要があります。指定しないと、呼び出しは失敗します。
    • インスタンスに対して 概要 ページまたは 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 エラーセンター をご確認ください。