すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:QuerySuperDeviceGroup

最終更新日:Apr 17, 2025

サブグループ ID によって親グループの情報を照会します。

制限

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

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

デバッグ

Alibaba Cloud は、API の使用を簡素化するために OpenAPI Explorer を提供しています。OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK 用の操作のサンプルコードを動的に生成します。

リクエストパラメーター

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

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

GroupIdStringはいDMoI2Kby5m62****

サブグループの ID。ID は、グループのグローバル一意識別子(GUID)です。

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

インスタンスの ID。インスタンス ID は、IoT Platform コンソールの 概要 ページで確認できます。

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

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

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

レスポンスパラメーター

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

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

DataGroupInfo の配列

呼び出しが成功した場合に返される親グループ情報。詳細については、以下の GroupInfo パラメーターをご参照ください。

GroupInfo
GroupDescStringA test

親グループの説明。

GroupIdStringtDQvBJqbUyHskDse

親グループの ID。

GroupNameStringIOTTEST

親グループの名前。

ErrorMessageStringA system exception occurred.

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

RequestIdString7411716B-A488-4EEB-9AA0-6DB05AD2491F

リクエストの ID。

SuccessBooleantrue

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

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

リクエストの例

https://iot.cn-shanghai.aliyuncs.com/?Action=QuerySuperDeviceGroup
&GroupId=DMoI2Kby5m62****
&<共通リクエストパラメーター>

成功レスポンスの例

XML 形式

<QuerySuperDeviceGroupResponse>
      <Data>
            <GroupName>IOTTEST</GroupName>
            <GroupId>tDQvBJqbUyHskDse</GroupId>
            <GroupDesc>A test.</GroupDesc>
      </Data>
      <RequestId>7411716B-A488-4EEB-9AA0-6DB05AD2491F</RequestId>
      <Success>true</Success>
</QuerySuperDeviceGroupResponse>

JSON 形式

{
    "Data":{
        "GroupName":"IOTTEST",
        "GroupId":"tDQvBJqbUyHskDse",
    "GroupDesc":"A test."
    },
    "RequestId":"7411716B-A488-4EEB-9AA0-6DB05AD2491F",
    "Success":true
}

エラーコード

エラーコードの一覧については、API エラーセンター をご参照ください。