IRPCVaultLoginsAdmin.GetWindowsGroupMembersInVault
Administration API / specialized admin session idempotent
Lists the users and groups that are members of a Windows group.
| Service | Vault login accounts MFiles.IRPCVaultLoginsAdmin |
|---|---|
| gRPC method | /MFiles.IRPCVaultLoginsAdmin/GetWindowsGroupMembersInVault |
| HTTP (mf-http-grpc) | POST /grpc/v1/get-windows-group-members-in-vault |
| Request | GetWindowsGroupMembersInVaultRequest |
| Response | GetWindowsGroupMembersInVaultResponse |
| Book and level | Administration API, specialized |
| Kind | admin |
| Session | Required: the session ID from LogIn in the mfiles-session-id-bin metadata. |
| Idempotent | yes |
| Returns metadata structure version | no |
| Streaming | none (unary) |
Remarks
- Requires the vault right
manage_users. Reads the vault's default user synchronization plugin if it synchronizes the group's domain, otherwise the domain directory.
Request: GetWindowsGroupMembersInVaultRequest
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
group_name | string | The group, for example DOMAIN\Domain Users. |
egim | ExternalGroupImportMode | Whether to include only direct members or also members of nested groups. See ExternalGroupImportMode.Values: EXTERNAL_GROUP_IMPORT_MODE_UNDEFINED (0), EXTERNAL_GROUP_IMPORT_MODE_DIRECT_USERS (1), EXTERNAL_GROUP_IMPORT_MODE_DIRECT_AND_NESTED_USERS (2). |
Response: GetWindowsGroupMembersInVaultResponse
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
users[] | repeated string | Member user names, for example DOMAIN\user. |
groups[] | repeated string | Member group names, for example DOMAIN\Group 1. |