Overview | Service | Command |
Returns groups the user is either a member or an owner of.
Notes:
Authorization token required | true |
Admin Authorization token required | false |
<GetAccountDistributionListsRequest [ownerOf="{owner-of} (0|1)"] [memberOf="{member-of} (all|directOnly|none)"]
[attrs="{attrs}"] /> ## GetAccountDistributionListsRequest
The following table describes elements and attributes you can define within a
<GetAccountDistributionListsRequest>
element:
XPath | Required / Optional | Description |
@ownerOf | Optional (0 or 1) | Type:0|1 Set to 1 if the response should include groups the user is an owner of. Set to 0 (default) if do not need to know which groups the user is an owner of. |
@memberOf | Optional (0 or 1) | Type:all|directOnly|none Possible values:
|
@attrs | Optional (0 or 1) | Type:String comma-seperated attributes to return. Note: non-owner user can see only certain attributes of a group. If a specified attribute is not visible to the user, it will not be returned. |
<GetAccountDistributionListsResponse> ## GetAccountDistributionListsResponse
(<dl ref="{dl-ldap-dn}" [d="{dl-display-name}"] [dynamic="{dl-is-dynamic} (0|1)"] [via="{via-dl-name}"]
[isOwner="{isOwner} (0|1)"] [isMember="{isMember} (0|1)"] name="{object-name}" id="{object-id}"> ## DLInfo
(<a n="{key}">{value}</a> ## KeyValuePair)*
</dl>)*
</GetAccountDistributionListsResponse>
The following table describes elements and attributes you can define within a
<GetAccountDistributionListsResponse>
element:
XPath | Required / Optional | Description |
/dl | Optional (0 or more) | Information on distribution lists |
/dl@ref | Required (only 1) | Type:String ldap dn of the DL. |
/dl@d | Optional (0 or 1) | Type:String Display name of group |
/dl@dynamic | Optional (0 or 1) | Type:0|1 Flags whether the group is dynamic or not |
/dl@via | Optional (0 or 1) | Type:String {via-dl-name} = is present if the account is a member of the returned list because they are either a direct or indirect member of another list that is a member of the returned list. For example, if a user is a member of engineering@domain.com, and engineering@domain.com is a member of all@domain.com, then the following would be returned: <dl name="all@domain.com" ... via="engineering@domain.com"/> |
/dl@isOwner | Optional (0 or 1) | Type:0|1 Flags whether user is the owner of the group. Only returned if ownerOf on the request is 1 (true) |
/dl@isMember | Optional (0 or 1) | Type:0|1 Flags whether user is a member of the group. Only returned if memberOf on the request is 1 (true) |
/dl@name | Required (only 1) | Type:String Name |
/dl@id | Required (only 1) | Type:String ID |
/dl/a | Optional (0 or more) | Type:{value} Attributes Description for element text content:Value |
/dl/a@n | Required (only 1) | Type:String Key |