物群組服務
物群組服務
下列服務可用來管理物群組。下列除 AssignMembersClearMembers 外的所有服務都會根據呼叫這些服務的目前使用者檢查成員實體的可見度權限。下列行為適用於這些服務:
如果為非管理員使用者提供適當的 ClearMembers 執行時間權限,且他們在物群組上執行 ClearMembers 服務,則會從物群組中清除所有成員,而不管非管理員使用者是否有權看到物群組內的成員。
如果為非管理員使用者提供適當的 AssignMembers 執行時間權限,且他們在物群組上執行 AssignMembers 服務,則會從物群組中清除所有成員,而不管非管理員使用者是否有權看到物群組內的現有成員。只有在非管理員使用者對 AssignMembers 服務呼叫裝載中的新成員可見時,服務才會成功執行。
如果為非管理員使用者提供新增與刪除服務的適當服務呼叫執行時間權限,且他們在物群組上執行其中任何一項服務,則只有在非管理員使用者對新增或刪除的特定成員也擁有可見度權限時,服務才會成功執行。
如果為非管理員使用者提供適當的服務呼叫執行時間權限,且他們在物群組上執行任何 Get 服務,則只會傳回非管理員使用者有權看到的實體。
服務名稱
參數
描述
AddMembers
members - 成員的 nametype
將多個成員 (物件與物群組) 以批次方式新增至呼叫服務時所在的物群組。AddMembers 不會像 AssignMembers 服務一樣清除現有成員。
AddThingGroupMember
memberName - 物群組的名稱。
將一個物群組成員新增至呼叫服務時所在的物群組。
AddThingMember
memberName - 物件的名稱。
將一個物件成員新增至呼叫服務時所在的物群組。
AssignMembers
members - 成員的 nametype (物件或物群組)。
清除所有成員,並將物件與/或物群組成員新增至呼叫服務時所在的物群組。
ClearMembers
刪除呼叫服務時所在之物群組的所有成員。
DeleteMembers
members - 成員的 nametype
以批次方式刪除呼叫服務時所在物群組的多個成員 (物件與物群組)。
DeleteThingGroupMember
memberName - 物群組的名稱。
刪除呼叫服務時所在物群組的一個物群組成員。
DeleteThingMember
memberName - 物件的名稱。
刪除呼叫服務時所在物群組的一個物件成員。
GetMembers
maxItems - 傳回的項目數上限。
傳回呼叫服務時所在之物群組的所有成員 (物件與物群組,僅限直接成員)。
GetThingGroupMembers
maxItems - 傳回的項目數上限。
傳回呼叫服務時所在之物群組的所有物群組成員 (僅限直接成員)。
GetThingGroupParentNames
maxItems - 傳回的項目數上限。
傳回呼叫服務時所在之物群組的所有直接物群組父項。
GetThingMembers
maxItems - 傳回的項目數上限。
傳回呼叫服務時所在之物群組的所有物件成員 (僅限直接成員)。
GetThingsInHierarchy
maxDepth - 深度搜尋層級上限。預設值 1 表示目前物群組實例子項層級。
maxItems - 傳回的項目數上限。
傳回階層中的所有物件,包括孫項物件與曾孫項物件。不會傳回階層內的物群組。
這是否有幫助?