Retrieve details of device pool by ID
Retrieve the details of a specific device pool by its numeric identifier (ID).
Prerequisites
Note: View the Control Room APIs in the
Community Edition, but API functionality is limited. You need a
licensed Automation 360 Edition to access the full functionality of
the APIs.
Ensure you have the following to use this API:
- View and manage ALL device(s): View and manage all the devices, including devices registerd by other users.
- All API calls must contain an authentication token in the request header. Use the Authentication API to generate a JSON Web Token. See Authentication API.
- Device pool id: The unique numeric identifier of the device pool for which you want to retrieve details.
This task searches in the Control Room for a specific device pool. The API passes the device pool {id} as part of the URL string. No request body is required.
Procedure
Evaluate these details:
- id
- The id uniquely identifies this device pool in the Control Room. Use this id as input for the poolIds for bot deployment.
- name
- This is the user-defined name for the device pool. Filter the device pool name using filters in the list device pools task.
- deviceIds
- List of the unique numeric IDs for Bot Runner devices that are part of this device pool.
- ownerIds
- The IDs of the owners of this device pool. Device pool owners can view, edit, or delete the device pool.
- consumerIds
- The IDs for users who can view this device while running automations.
The REST API responds to each request with an HTTP response code. For response codes, see API response codes.