# get\_server\_details

Retrieves details about the specified server.

Required User Role: See [Required Enterprise Manager permissions](https://help.qlik.com/en-US/enterprise-manager/November2025/Content/EnterpriseManager/EnterpriseManager_APIGuide/Introduction/AEMPermissions.htm).

## Syntax

`def get_server_details(` ` self,  ` `server` `)`

## Parameters

Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| server | string | The specified server name in Qlik Enterprise Manager. |

## Return values

AemGetServerDetailsResp

Return values

| Value | Type | Description |
| --- | --- | --- |
| server\_details | AemServerDetails | ReplicateServerDetails or ComposeServerDetails that are inherited from AemServerDetails. |
| configuration | - | - |
| host | string | The host name or IP address of the Replicate/Compose Server machine. |
| platform | AemPlatform `{<br>``		UNKNOWN = 0,``<br>		WINDOWS = 1,<br>``		LINUX = 2<br>``	}<br>` | The platform on which the Replicate/Compose Server machine is installed. |
| port | string | The port through which the Replicate/Compose Server machine is accessed. |
| user\_name | string | The user name for connecting to the Replicate/Compose Server machine. |
| description | string | The server description. |
| last\_connection | string | The date and time of the last successful sync/retrieval of tasks and messages. |
| license | ApiLicense | - |
| days\_to\_expiration | int | The number of days left before the license expires. |
| expiration | string | The expiration date of the server license. |
| issue\_date | string | When the license was issued. |
| state | AemLicenseState<br><br>{<br><br>VALID\_LICENSE = 0,<br><br>INVALID\_LICENSE\_CHECKSUM = 1,<br><br>EXPIRED\_LICENSE = 2,<br><br>NO\_LICENSE = 3,<br><br>MACHINE\_NOT\_LICENSED = 4,<br><br>INVALID\_LICENSE = 5<br><br>} | The current license state (for example, valid, expired, and so on). |
| message | string | The error message if Qlik Enterprise Manager fails to connect to the Replicate/Compose Server machine. |
| name | string | The name of the server in Qlik Enterprise Manager. |
| resource\_utilization | AemServerUtilization | - |
| attunity\_cpu\_percentage | int | The sum of CPU percentage of Replicate server and all running tasks processes. |
| disk\_usage\_mb | long | The amount of disk space that the server is currently consuming, in MB. This is the sum of disk usage for all tasks on this server. |
| machine\_cpu\_percentage | int | The CPU percentage of the machine where Replicate is installed. |
| memory\_mb | long | The amount of memory that the server is currently consuming, in MB. This is the sum of memory usage for all active tasks on this server, excluding stopped tasks. |
| state | AemServerState<br><br>`{`<br>`NOT_MONITORED = 0,`<br>`MONITORED = 1,`<br>`ERROR = 2`<br>`}` | The state of the server. |
| aem\_tasks\_summary | TaskSummary | - |
| error | int | The number of tasks that encountered a fatal error. |
| recovering | int | The number of recovering tasks |
| running | int | The number of running tasks. |
| stopped | int | The number of stopped tasks. |
| total | int | The total number of tasks, regardless of state. |
| version | string | The Replicate/Compose Server version. |

Information note

* The return value -1 means N/A.
* Parameters related to Disk, Memory, Qlik CPU, and Machine CPU usage are not available for Compose servers. For Compose servers, these parameters will be returned as -1.
* Parameters related to Qlik CPU and Machine CPU usage are only available for Replicate 6.2 and above. For earlier Replicate versions, these parameters will be returned as -1.
* For servers that are in an error state or not monitored, parameters related to Disk and Memory usage will be returned as -1.

## Errors

Error responses

| Error | Message | Description |
| --- | --- | --- |
| AEM\_SERVER\_NOT\_FOUND | Replicate server {server} could not be found. | Server name unknown to Qlik Enterprise Manager. |

See [Error handling](https://help.qlik.com/en-US/enterprise-manager/November2025/Content/EnterpriseManager/EnterpriseManager_APIGuide/NetAPI/error_handling.htm).