Skip to main content

agent_pools

Creates, updates, deletes, gets or lists an agent_pools resource.

Overview

Nameagent_pools
TypeResource
Idokta.agentpools.agent_pools

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringAgent pool ID
namestringAgent pool name
_linksobjectSpecifies link relations (see Web Linking) available using the JSON Hypertext Application Language specification. This object is used for dynamic discovery of related resources and lifecycle operations.
agentsarray
disruptedAgentsintegerNumber of agents in the pool that are in a disrupted state
inactiveAgentsintegerNumber of agents in the pool that are in an inactive state
operationalStatusstringOperational status of a given agent
typestringAgent types that are being monitored

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_agent_poolsselectsubdomainlimitPerPoolType, poolType, afterLists all agent pools with pagination support

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
subdomainstringThe domain of your organization. This can be a provided subdomain of an official okta domain (okta.com, oktapreview.com, etc) or one of your configured custom domains. (default: my-org)
afterstringThe cursor to use for pagination. It is an opaque string that specifies your current location in the list and is obtained from the Link response header. See Pagination.
limitPerPoolTypeintegerMaximum number of agent pools returned
poolTypestringAgent type to search for

SELECT examples

Lists all agent pools with pagination support

SELECT
id,
name,
_links,
agents,
disruptedAgents,
inactiveAgents,
operationalStatus,
type
FROM okta.agentpools.agent_pools
WHERE subdomain = '{{ subdomain }}' -- required
AND limitPerPoolType = '{{ limitPerPoolType }}'
AND poolType = '{{ poolType }}'
AND after = '{{ after }}';