put_endpoints_collection_acl
Sets a list of users/groups that have permissions on all endpoints in Qlik Enterprise Manager.
The method will replace any existing explicit ACL with the ACL in the request.
The request also includes a Boolean flag for specifying if the endpoints should inherit ACLs from their ancestors (in addition to their explicitly defined ACLs) or not.
The inherited ACLs (that is, the ACLs of an endpoint's ancestors) are not affected by this method.
The put_endpoints_collection_acl can be used together with the get_endpoints_collection_acl method in order to update an existing endpoint's ACL. First call get_endpoints_collection_acl, then edit the returned roles as required, and finally, call put_endpoints_collection_acl.
Required User Role: See Required Enterprise Manager permissions.
Behavior when putting a partial request:
When the request body includes only some of the roles (as opposed to all four of them), only the roles specifically defined in the request body will be set on the endpoints; roles that are missing or empty will be inherited, but only if the following are true:
- The disable_inheritance flag is set to "True".
- The roles that are missing/empty in the request are defined for the ancestors.
Behavior on conflicts:
If the disable_inheritance flag is set to "False" and the explicit roles in the request conflict with existing inherited roles, then the explicit roles will take precedence. For example, if the request defines user A as a Viewer on Myendpoint and user A is also defined as an Admin on All endpoints, then user A will be defined as an Admin on All endpoints but as a Viewer on Myendpoint.
The user permissions in Enterprise Manager are completely independent of the user permissions in Replicate. Consequently, AemPutServerAcl will affect the server's Enterprise Manager user permissions, but will not affect Replicate's user permissions.
Moreover, when performing an operation via Enterprise Manager, the user permissions defined for the server entity in Enterprise Manager apply, whereas when performing an operation directly via the Replicate Console, the user permissions defined in Replicate apply.
Defining the same user/group in different roles is not allowed. However, if the same user or group is defined in different roles but with a different case (for example, Mike vs. mike or Analysts vs. ANALYSTS), no error will be returned and the strongest role will take precedence.
Required User Role: See Required Enterprise Manager permissions.
Syntax
def put_endpoints_collection_acl(
self,
payload,
server
)
Parameters
| Parameter | Type | Description |
|---|---|---|
|
payload |
AemAuthorizationAcl |
- |
|
DisableInheritance |
bool |
If set to "true", the endpoint does not inherit ACLs from its ancestors (in addition to its explicit ACLs). If set to "false", the endpoint inherits ACLs from its ancestors, in addition to any explicit ACLs. |
|
AdminRole |
AemRoleDef |
Users and/or groups assigned as Admin role. |
|
DesignerRole |
AemRoleDef |
Users and/or groups assigned as Designer role. |
|
OperatorRole |
AemRoleDef |
Users and/or groups assigned as Operator role. |
|
ViewerRole |
AemRoleDef |
Users and/or groups assigned as Viewer role. |
| NoneRole | AemRoleDef |
Users and/or groups without a role on the endpoints. |
|
Groups |
List<AemGroupRef> |
Groups assigned as the role. |
|
Name |
string |
The group name. |
|
Users |
List<AemUserRef> |
Users assigned as the role. |
|
Name |
string |
The user name. |
|
server |
string |
The name of the server on which to put the ACL for users/groups with permissions on all endpoints. |
Return values
N/A
Errors
All of the general errors as well as the errors listed in the table below.
| Error | Message | Description |
|---|---|---|
|
DESERIALIZE_TO_TYPE |
"Failed to deserialize json to type AemAuthorizationAcl: {message}" |
Returned when the JSON format is invalid. For example, such an error will be returned if the JSON contains an unknown role. |
|
AEM_PUT_endpoint_ACL_INNER_ERR |
Failed to put ACL of endpoint "{endpoint}". Error: "{message}". |
Returned if Qlik Enterprise Manager encounters an error/exception when trying to put the endpoint's ACL. |
|
AEM_NO_ DOMAIN_IN_USER |
User "{userName}" must be preceded by a domain name, separated by a backslash. Example: domain_name\user_name. |
Returned when the domain is missing from the user name. |
|
AEM_NO_ DOMAIN_IN_GROUP |
Group "{groupName}" must be preceded by a domain name, separated by a backslash. Example: domain_name\group_name. |
Returned when the domain is missing from the group name. |
|
AEM_NO_ADMIN_ON_endpoint |
Requested endpoint "{endpoint}" has no admin user. At least one user or group must be assigned to the "admin" role. |
Returned when there is no admin on the endpoint. Possible reasons:
|
|
AEM_USER_ASSIGNED_TO_MULTIPLE_ROLES |
User "{userName}" is assigned to multiple roles. Users can only be assigned to a single role. |
Returned when a user is assigned to multiple roles. |
| AEM_GROUP_ASSIGNED_TO_MULTIPLE_ROLES |
Group "{groupName}" is assigned to multiple roles. Groups can only be assigned to a single role. |
Returned when a group is assigned to multiple roles. |
|
AEM_USER_GROUP_MULTIPLE_ASSIGNED |
"{userName/groupName}" is assigned to multiple roles or to the same role twice. Users/groups can only be assigned once, and to a single role. |
Returned either when the specified user already exists as a group in the same/another role, or the specified group already exists as a user in the same/another role. |