BatchDeleteDeviceGroupRelations - IoT Platform - Alibaba Cloud ドキュメントセンター

指定されたグループから複数のデバイスを削除します。この操作を呼び出すと、デバイスとグループ間の関係のみを削除できます。これらのデバイスは削除されません。

制限

Alibaba Cloud アカウントごとに、最大 50 クエリ/秒（QPS）を実行できます。

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

デバッグ

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

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
Action	String	はい	BatchDeleteDeviceGroupRelations	実行する操作。値を BatchDeleteDeviceGroupRelations に設定します。
Device.N.DeviceName	String	はい	ZHuPo6sZzv7pOzYh****	削除するデバイスの名前。最大 200 台のデバイスを指定できます。
Device.N.ProductKey	String	はい	a1kORrK****	デバイスが属するプロダクトの ProductKey。最大 200 の ProductKey を指定できます。
GroupId	String	はい	W16X8Tvdosec****	グループの ID。ID は、グループのグローバル一意識別子（GUID）です。
IotInstanceId	String	いいえ	iot_instc_pu***_c-v64********	インスタンスの ID。インスタンス ID は、IoT Platform コンソールの概要ページで確認できます。重要インスタンスに ID がある場合は、このパラメーターを設定する必要があります。このパラメーターを設定しないと、呼び出しは失敗します。インスタンスに概要ページまたは ID がない場合は、このパラメーターを設定する必要はありません。詳細については、「概要」をご参照ください。

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

レスポンスパラメーター

パラメーター	タイプ	例	説明
AlreadyRelatedGroupDeviceCount	Integer	2	グループに存在するデバイスの数。
Code	String	iot.system.SystemException	呼び出しが失敗した場合に返されるエラーコード。詳細については、「エラーコード」をご参照ください。
ErrorMessage	String	システム例外が発生しました。	呼び出しが失敗した場合に返されるエラーメッセージ。
RequestId	String	8739385E-143F-4389-B900-B7DF9174CE0D	リクエストの ID。
Success	Boolean	true	呼び出しが成功したかどうかを示します。 true: 呼び出しは成功しました。 false: 呼び出しは失敗しました。
SuccessDeviceCount	Integer	2	グループから削除されたデバイスの数。
ValidDeviceCount	Integer	2	指定した有効なデバイスの数。

例

リクエストの例

https://iot.cn-shanghai.aliyuncs.com/?Action=BatchDeleteDeviceGroupRelations
&Device.1.DeviceName=ZHuPo6sZzv7pOzYh****
&Device.1.ProductKey=a1kORrK****
&Device.2.DeviceName=rB4V9PDW2FCPmwuf****
&Device.2.ProductKey=a1kORrK****
&GroupId=W16X8Tvdosec****
&<共通リクエストパラメーター>

成功レスポンスの例

XML 形式

<BatchDeleteDeviceGroupRelationsResponse>
      <SuccessDeviceCount>2</SuccessDeviceCount>
      <ValidDeviceCount>2</ValidDeviceCount>
      <AlreadyRelatedGroupDeviceCount>2</AlreadyRelatedGroupDeviceCount>
      <RequestId>8739385E-143F-4389-B900-B7DF9174CE0D</RequestId>
      <Success>true</Success>
</BatchDeleteDeviceGroupRelationsResponse>

JSON 形式

{
    "SuccessDeviceCount":2,
    "ValidDeviceCount":2,
    "AlreadyRelatedGroupDeviceCount":2,
    "RequestId":"8739385E-143F-4389-B900-B7DF9174CE0D",
    "Success":true    
}

エラーコード

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