Get Application Pool

Get Application Pool

All the listed privileges are required -

Privileges Description
POOL_VIEW Caller should have permission to this privilege, on the associated access group of the application pool.
Request
URI
GET
https://{api_host}//localhost/rest/inventory/v1/application-pools/{id}
COPY
Path Parameters
string
id
Required

id


Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns ApplicationPoolInfo of type(s) */*
{
    "access_group_id": "6fd4638a-381f-4518-aed6-042aa3d9f14c",
    "anti_affinity_data": {
        "anti_affinity_count": 10,
        "anti_affinity_patterns": [
            "*pad.exe",
            "*notepad.???"
        ]
    },
    "category_folder_name": "dir1\\dir2\\dir3\\dir4",
    "cs_restriction_tags": [
        "Internal",
        "External"
    ],
    "customized_icon_ids": [
        "e8d7bf41-0fcd-477a-b7e0-1338b3868d26",
        "b5453336-01c6-4d44-b2f4-7bcdbcf7b82e"
    ],
    "description": "string",
    "desktop_pool_id": "0103796c-102b-4ed3-953f-3dfe3d23e0fe",
    "display_name": "Firefox",
    "enable_client_restrictions": false,
    "enable_pre_launch": false,
    "enabled": true,
    "executable_path": "C:\\ProgramData\\Microsoft\\Windows\\Start Menu\\Programs\\Firefox.lnk",
    "farm_id": "855ea6c5-720a-41e1-96f4-958c90e6e424",
    "icon_ids": [
        "200fd5fd-26d6-490e-b023-509cbe19c0ac",
        "920b7766-87b4-4712-9dac-1e7afcba28a6"
    ],
    "id": "6f85b3a5-e7d0-4ad6-a1e3-37168dd1ed51",
    "max_multi_sessions": 5,
    "multi_session_mode": "ENABLED_ENFORCED",
    "name": "Firefox",
    "parameters": "string",
    "publisher": "Mozilla Corporation",
    "shortcut_locations": [
        "string"
    ],
    "start_folder": "string",
    "supported_file_types_data": {
        "enable_auto_update_file_types": true,
        "enable_auto_update_other_file_types": true,
        "file_types": [
            {
                "description": "Firefox Document",
                "type": ".html"
            }
        ],
        "other_file_types": [
            {
                "description": "Firefox URL",
                "name": "https",
                "type": "URL"
            }
        ]
    },
    "version": "72.0.2"
}
string
access_group_id
Optional

Access groups can organize the entities (like application pools, desktop pools) in the organization. They can also be used for delegated administration. For application pool, this is the same as that of the farm or desktop pool that the application pool belongs to.
Supported Filters: 'Equals'.

anti_affinity_data
Optional

anti_affinity_data

string
category_folder_name
Optional

Name of the category folder in the user's OS containing a shortcut to the application. Unset if the application does not belong to a category.

array of string
cs_restriction_tags
Optional

Connection server restrictions. Application pool can be accessed from only those connection server instances that have a matching tag in this list. Null or empty list means that the application pool can be accessed from any connection server.

array of string
customized_icon_ids
Optional

List of customized icon IDs associated with the application which the user has configured.

string
description
Optional

Notes about the application pool.
Supported Filters: 'Equals', 'StartsWith' and 'Contains'.

string
desktop_pool_id
Optional

ID of the desktop pool from which this application pool is created. Either this or farm id will be set.
Supported Filters: 'Equals'.

string
display_name
Optional

The display name is the name that users will see when they connect to view client. If the display name is left blank, it defaults to name.
Supported Filters: 'Equals', 'StartsWith' and 'Contains'.

boolean
enable_client_restrictions
Optional

Indicates whether client restrictions are to be applied to application pool. Currently it is valid for application pool created from farm.
Supported Filters: 'Equals'.

boolean
enable_pre_launch
Optional

Whether to pre-launch the application.
Supported Filters: 'Equals'.

boolean
enabled
Optional

Indicates whether the application pool is enabled.
Supported Filters: 'Equals'.

string
executable_path
Optional

Path to application executable.
Supported Filters: 'Equals', 'StartsWith', 'EndsWith' and 'Contains'.

string
farm_id
Optional

ID of the farm from which this application pool is created. Either this or desktop pool id will be set.
Supported Filters: 'Equals'.

array of string
icon_ids
Optional

List of icon IDs associated with the application which are fetched from the agent.

string
id
Optional

Unique ID representing application pool.
Supported Filters: 'Equals'.

integer As int32 As int32
max_multi_sessions
Optional

Maximum number of multi-sessions a user can have in this application pool. This property is required if multi-session mode is set to "ENABLED_DEFAULT_OFF", "ENABLED_DEFAULT_ON", or "ENABLED_ENFORCED"

string
multi_session_mode
Optional

Multi-session mode for the application pool. An application launched in multi-session mode does not support reconnect behavior when user logs in from a different client instance. Multi-session mode should be disabled when pre-launch is enabled.
Supported Filters: 'Equals'.

  • DISABLED: Multi-session is not supported for this application.
  • ENABLED_DEFAULT_OFF: Multi-session is supported for this application but is disabled by default. The client would need to explicitly request multi-session launch, if wanted. If a legacy client is used, this will always result in a single-session application launch.
  • ENABLED_DEFAULT_ON: Multi-session mode is supported for this application and is enabled by default. The client can request explicitly for single-session launch, if wanted. If a legacy client is used, this will always result in a multi-session application launch.
  • ENABLED_ENFORCED: Multi-session is supported for this application and it is enforced. The client can not select to launch this application as a single-session application.
Possible values are : DISABLED, ENABLED_DEFAULT_OFF, ENABLED_DEFAULT_ON, ENABLED_ENFORCED,
string
name
Optional

The application name is the unique identifier used to identify this application pool. This property must contain only alphanumerics, underscores, and dashes. The maximum length is 64 characters.
Supported Filters: 'Equals', 'StartsWith' and 'Contains'.

string
parameters
Optional

Parameters to pass to application when launching.

string
publisher
Optional

Application publisher.
Supported Filters: 'Equals', 'StartsWith' and 'Contains'.

array of string
shortcut_locations
Optional

Locations of the category folder in the user's OS containing a shortcut to the application. The value must be set if category folder name is provided.

Possible values are : START_MENU, DESKTOP,
string
start_folder
Optional

Starting folder for application.

supported_file_types_data
Optional

supported_file_types_data

string
version
Optional

Application version.
Supported Filters: 'Equals', 'StartsWith' and 'Contains'.


400

Bad Request

Operation doesn't return any data structure

401

User is not authenticated

Operation doesn't return any data structure

403

Access to the resource is forbidden

Operation doesn't return any data structure

404

Not Found

Operation doesn't return any data structure

Inventory Operations
POST
Add Custom Icon
POST
Add Local Application Pools To GAE
POST
Add Local Desktop Pools To GDE
POST
Add Machines
POST
Add Machines By Name
POST
Add Rds Servers
POST
Archive Machines
POST
Assign Machine Aliases
POST
Assign Users
POST
Cancel Desktop Pool Task
POST
Cancel Scheduled Maintenance
POST
Cancel Scheduled Push Image
POST
Check Application Pool Name Availability
POST
Check Desktop Pool Name Availability
POST
Check Farm Name Availability
POST
Check Machine Prefix Availability
POST
Check RDS Server Prefix Availability
POST
Create Application Icon
POST
Create Application Pool
POST
Create Application Pool V2
POST
Create Desktop Pool
POST
Create Desktop Pool V2
POST
Create Farm
POST
Create Farm V2
POST
Create Farm V3
POST
Create Global Application Entitlement
POST
Create Global Desktop Entitlement
POST
Create Global Desktop Entitlement V2
DELETE
Delete Application Pool
DELETE
Delete Desktop Pool
DELETE
Delete Farm
DELETE
Delete Global Application Entitlement
DELETE
Delete Global Desktop Entitlement
DELETE
Delete Machine
DELETE
Delete Machines
DELETE
Delete Physical Machine
DELETE
Delete RDS Server
POST
Desktop Pool Apply Image
POST
Desktop Pool Promote Pending Image
POST
Disconnect Global Sessions
POST
Disconnect Sessions
POST
Enter Maintenance
POST
Exit Maintenance
POST
Farm Apply Image
POST
Farm Promote Pending Image
GET
Get Application Icon
GET
Get Application Pool
GET
Get Application Pool V2
GET
Get Application Pool V3
GET
Get Desktop Pool
GET
Get Desktop Pool Task
GET
Get Desktop Pool V2
GET
Get Desktop Pool V3
GET
Get Desktop Pool V4
GET
Get Desktop Pool V5
GET
Get Desktop Pool V6
GET
Get Farm
GET
Get Farm V2
GET
Get Farm V3
GET
Get Farm V4
GET
Get Global Application Entitlement
GET
Get Global Application Entitlement V2
GET
Get Global Desktop Entitlement
GET
Get Global Desktop Entitlement V2
GET
Get Machine
GET
Get Machine V2
GET
Get Machine V3
GET
Get Physical Machine
GET
Get Physical Machine V2
GET
Get RDS Server
GET
Get Session Info
GET
List Application Icons
GET
List Application Pools
GET
List Application Pools V2
GET
List Application Pools V3
GET
List Compatible Backup GA Es
GET
List Compatible Backup GD Es
GET
List Compatible Local Application Pools
GET
List Compatible Local Desktop Pools
GET
List Desktop Pools
GET
List Desktop Pools V2
GET
List Desktop Pools V3
GET
List Desktop Pools V4
GET
List Desktop Pools V5
GET
List Desktop Pools V6
GET
List Desktop Pool Tasks
GET
List Farms
GET
List Farms V2
GET
List Farms V3
GET
List Farms V4
GET
List Global Application Entitlements
GET
List Global Application Entitlements V2
GET
List Global Desktop Entitlements
GET
List Global Desktop Entitlements V2
GET
List Installed Applications On Desktop Pool
GET
List Installed Applications On Farm
GET
List Local Application Pools
GET
List Local Desktop Pools
GET
List Machines
GET
List Machines V2
GET
List Machines V3
GET
List Physical Machines
GET
List Physical Machines V2
GET
List RDS Servers
GET
List Session Info
POST
Log Off Global Sessions
POST
Log Off Sessions
POST
Pause Desktop Pool Task
GET
Query Global Sessions
POST
Rebuild Machines
POST
Recover Machines
POST
Recover RDS Servers
POST
Register Physical Machine
POST
Register RDS Server
POST
Remove Custom Icon
DELETE
Remove Local Application Pools From GAE
DELETE
Remove Local Desktop Pools From GDE
POST
Remove Machines
POST
Remove Rds Servers
POST
Reset Global Sessions
POST
Reset Machines
POST
Reset Sessions
POST
Restart Global Sessions
POST
Restart Machines
POST
Restart Sessions
POST
Resume Desktop Pool Task
POST
Schedule Maintenance
POST
Schedule Maintenance V2
POST
Schedule Push Image
POST
Schedule Push Image V2
POST
Send Message To Global Sessions
POST
Send Message To Sessions
POST
Unassign Machine Aliases
POST
Unassign Users
PUT
Update Application Pool
PUT
Update Application Pool V2
PUT
Update Desktop Pool
PUT
Update Farm
PUT
Update Farm V2
PUT
Update Farm V3
PUT
Update Global Application Entitlement
PUT
Update Global Desktop Entitlement
PUT
Update RDS Server
POST
Validate Installed Applications On Desktop Pool
POST
Validate Installed Applications On Farm
POST
Validate Specified Names