サブグループ ID によって親グループの情報を照会します。
制限
各 Alibaba Cloud アカウントは、最大 10 クエリ/秒(QPS)を実行できます。
説明 Alibaba Cloud アカウントの RAM ユーザーは、アカウントのクォータを共有します。
デバッグ
リクエストパラメーター
| パラメーター | タイプ | 必須 | 例 | 説明 |
| Action | String | はい | QuerySuperDeviceGroup | 実行する操作。値を QuerySuperDeviceGroup に設定します。 |
| GroupId | String | はい | DMoI2Kby5m62**** | サブグループの ID。ID は、グループのグローバル一意識別子(GUID)です。 |
| IotInstanceId | String | いいえ | iot_instc_pu****_c*-v64******** | インスタンスの ID。インスタンス ID は、IoT Platform コンソールの 概要 ページで確認できます。 重要
詳細については、「概要」をご参照ください。 |
上記の操作固有のリクエストパラメーターに加えて、この操作を呼び出すときは、共通のリクエストパラメーターを指定する必要があります。詳細については、「共通リクエストパラメーター」をご参照ください。
レスポンスパラメーター
| パラメーター | タイプ | 例 | 説明 |
| Code | String | iot.system.SystemException | 呼び出しが失敗した場合に返されるエラーコード。詳細については、「エラーコード」をご参照ください。 |
| Data | GroupInfo の配列 | 呼び出しが成功した場合に返される親グループ情報。詳細については、以下の GroupInfo パラメーターをご参照ください。 | |
| GroupInfo | |||
| GroupDesc | String | A test | 親グループの説明。 |
| GroupId | String | tDQvBJqbUyHskDse | 親グループの ID。 |
| GroupName | String | IOTTEST | 親グループの名前。 |
| ErrorMessage | String | A system exception occurred. | 呼び出しが失敗した場合に返されるエラーメッセージ。 |
| RequestId | String | 7411716B-A488-4EEB-9AA0-6DB05AD2491F | リクエストの ID。 |
| Success | Boolean | true | 呼び出しが成功したかどうかを示します。
|
例
リクエストの例
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 エラーセンター をご参照ください。