get_endpoint_acl
Retrieves the explicit ACL defined in Qlik Enterprise Manager for the specified endpoint, including a Boolean indication if ACL inheritance is disabled or enabled for the endpoint.
The method returns the explicit ACL only. In other words, it does not return inherited ACLs.
If all of the endpoint ACLs are inherited (i.e. no ACL was explicitly defined for the endpoint), an error will be returned indicating that no ACL was found.
This method can be used together with put_endpoint_aclin order to update an existing server's ACL. First, call get_endpoint_acl, then edit the returned roles as required, and finally, call put_endpoint_acl.
Required User Role: See Required Enterprise Manager permissions.
Syntax
def get_endpoint_acl(
self,
server
endpoint
)
Parameters
| Parameter | Type | Description |
| server | string | The name of the server where the endpoint ACL is located. |
| endpoint | string | The name of the endpoint whose ACL you want to retrieve. |
Return values
AemAuthorizationAcl
| Parameter | Type | Description |
|
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. |
|
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. |
Errors
All of the general errors as well as the errors listed in the table below.
| Error | Message | Description |
|
AEM_GET_endpoint_ACL_INNER_ERR |
Failed to get ACL of endpoint "{endpoint}". Error: "{message}". |
Returned if Qlik Enterprise Manager encounters an error/exception when trying to get the endpoint ACL. |
|
AEM_endpoint_HAS_NO_ACL |
ACL for endpoint "{endpoint}" could not be found. |
Returned if no explicit ACL is defined for the endpoint. Information note
A endpoint that does not have its own explicit ACL inherits the ACL from its ancestors. Inherited ACLs are not returned by this method. |