Thing Group のサービス
Thing Group のサービス
Thing Group 管理では以下のサービスを使用できます。AssignMembers および ClearMembers を除く以下のすべてのサービスは、メンバーエンティティの表示アクセス許可を、それらのサービスを呼び出している現在のユーザーと照らしてチェックします。これらのサービスには以下の動作が適用されます。
非管理者ユーザーに適切な ClearMembers ランタイムアクセス許可が付与されている場合、それらのユーザーが Thing Group に対して ClearMembers サービスを実行すると、非管理者ユーザーがその Thing Group 内のメンバーを表示する権限を持っているかどうかにかかわらず、その Thing Group からすべてのメンバーが消去されます。
非管理者ユーザーに適切な AssignMembers ランタイムアクセス許可が付与されている場合、それらのユーザーが Thing Group に対して AssignMembers サービスを実行すると、非管理者ユーザーがその Thing Group 内の既存のメンバーを表示する権限を持っているかどうかにかかわらず、その Thing Group からすべてのメンバーが消去されます。このサービスは、非管理者ユーザーが AssignMembers サービス呼び出しペイロード内の新規メンバーを表示できる場合にのみ、正常に実行されます。
非管理者ユーザーに追加サービスと削除サービスに対する適切なサービス呼び出しランタイムアクセス許可が付与されている場合、それらのサービスのいずれかを Thing Group に対して実行すると、非管理者ユーザーが追加または削除する特定のメンバーに対する表示アクセス許可も持っている場合にのみ、それらのサービスは正常に実行されます。
非管理者ユーザーに適切なサービス呼び出しランタイムアクセス許可が付与されている場合、いずれかの取得サービスを Thing Group に対して実行すると、非管理者ユーザーが表示権限を持つエンティティだけが返されます。
サービス名
パラメータ
説明
AddMembers
members - メンバーの名前タイプ
サービスが呼び出される Thing Group に複数のメンバー (Thing および Thing Group) をバッチとして追加します。AddMembers では AssignMembers サービスのように既存のメンバーがクリアされることはありません。
AddThingGroupMember
memberName - Thing Group の名前。
サービスが呼び出される Thing Group に Thing Group メンバーを 1 つ追加します。
AddThingMember
memberName - Thing の名前。
サービスが呼び出される Thing Group に Thing メンバーを 1 つ追加します。
AssignMembers
members - メンバーの名前タイプ (Thing または Thing Group)。
すべてのメンバーをクリアし、サービスが呼び出される Thing Group に Thing または Thing Group メンバーを追加します。
ClearMembers
サービスが呼び出される Thing Group のすべてのメンバーを削除します。
DeleteMembers
members - メンバーの名前タイプ
サービスが呼び出される Thing Group から複数のメンバー (Thing および Thing Group) をバッチとして削除します。
DeleteThingGroupMember
memberName - Thing Group の名前。
サービスが呼び出される Thing Group から Thing Group メンバーを 1 つ削除します。
DeleteThingMember
memberName - Thing の名前。
サービスが呼び出される Thing Group から Thing メンバーを 1 つ削除します。
GetMembers
maxItems - 返されるアイテムの最大数。
サービスが呼び出される Thing Group のすべてのメンバー (Thing および Thing Group、直系メンバーのみ) を返します。
GetThingGroupMembers
maxItems - 返されるアイテムの最大数。
サービスが呼び出される Thing Group のすべての Thing Group メンバー (直系メンバーのみ) を返します。
GetThingGroupParentNames
maxItems - 返されるアイテムの最大数。
サービスが呼び出される Thing Group のすべての直系親 Thing Group を返します。
GetThingMembers
maxItems - 返されるアイテムの最大数。
サービスが呼び出される Thing Group のすべての Thing メンバー (直系メンバーのみ) を返します。
GetThingsInHierarchy
maxDepth - サーチの最大深さレベル。デフォルト値 1 は、現在の Thing Group インスタンスの子レベルを示します。
maxItems - 返されるアイテムの最大数。
孫 Thing やひ孫 Thing など、階層内のすべての Thing を返します。階層内の Thing Group は返しません。
これは役に立ちましたか?