すべてのプロダクト
Search

このプロダクト

    IoT Platform:RemoveThingTopo

    ドキュメントセンター

    IoT Platform:RemoveThingTopo

    最終更新日:Apr 17, 2025

    ゲートウェイと接続されているすべてのサブデバイス間のトポロジ関係、またはサブデバイスと、サブデバイスが接続されているゲートウェイ間のトポロジ関係を削除します。

    使用方法

    • ゲートウェイを指定すると、この操作はゲートウェイと接続されているすべてのサブデバイス間のトポロジ関係を削除します。

    • サブデバイスを指定すると、この操作はサブデバイスと、サブデバイスが接続されているゲートウェイ間のトポロジ関係を削除します。

    QPS 制限

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

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

    デバッグ

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

    リクエストパラメータ

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

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

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

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

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

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

    ProductKeyStringいいえa1BwAGV****

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

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

    デバイスの DeviceName。

    説明 このパラメータに値を指定する場合は、ProductKey パラメータにも値を指定する必要があります。
    IotIdStringいいえQ7uOhVRdZRRlDnTLv****00100

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

    説明 このパラメータに値を指定する場合は、ProductKey パラメータまたは DeviceName パラメータに値を指定する必要はありません。 IotId パラメータは、デバイスのグローバル一意識別子（GUID）を指定します。 IotId パラメータの値は、ProductKey パラメータと DeviceName パラメータの値の組み合わせに対応します。 IotId パラメータに値を指定し、ProductKey パラメータと DeviceName パラメータにも値を指定した場合、IotId パラメータの値が優先されます。

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

    レスポンスパラメータ

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

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

    DataBooleantrue

    トポロジ関係が削除されたかどうかを示します。

    • true: トポロジ関係が削除されました。
    • false: トポロジ関係の削除に失敗しました。
    ErrorMessageStringシステム例外が発生しました。

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

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

    リクエストの ID。

    SuccessBooleantrue

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

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

    例

    リクエストの例

    https://iot.cn-shanghai.aliyuncs.com/?Action=RemoveThingTopo
&ProductKey=a1bPo9p****
&DeviceName=device1
&<共通リクエストパラメータ>

    成功レスポンスの例

    XML 形式

    <RemoveThingTopoResponse>
  <Data>true</Data>
  <RequestId>098BEEF4-58F4-4181-A891-5D37DB6C4C3B</RequestId>
  <Success>true</Success>
</RemoveThingTopoResponse>

    JSON 形式

    {
    "Data": true,
    "RequestId": "098BEEF4-58F4-4181-A891-5D37DB6C4C3B",
    "Success": true
}

    エラーコード

    エラーコードのリストについては、API エラーセンターをご覧ください。