runners

Creates, updates, deletes, gets or lists a runners resource.

Overview

Name	runners
Type	Resource
Id	pagerduty.automation_actions.runners

Fields

The following fields are returned by SELECT queries:

get_automation_actions_runner

Runner information

Name	Datatype	Description
id	string
name	string	(example: us-west-2 prod runner)
associated_actions	object	References to at most 3 actions associated with the Runner. Use appropriate endpoints to retrieve the full list of associated actions.
creation_time	string (date-time)
description	string	(example: us-west-2 runner provisioned in the production environment by the SRE team)
html_url	string (url)	a URL at which the entity is uniquely displayed in the Web app
last_seen	string (date-time)
metadata	object	Additional metadata
privileges	object
runbook_base_uri	string	The base URI of the Runbook server to connect to. May only contain alphanumeric characters, periods, underscores and dashes. (example: subdomain)
runner_type	string	sidecar -- The runner is backed by an external sidecar that polls for invocations. runbook -- The runner communicates directly with a runbook instance. (example: runbook)
self	string (url)	the API show URL at which the object is accessible
status	string	Configured -- Runner has connected to the backend at least once NotConfigured -- Runner has never connected to backend (example: Configured)
summary	string	A short-form, server-generated string that provides succinct, important information about an object suitable for primary labeling of an entity in a client. In many cases, this will be identical to name, though it is not intended to be an identifier.
teams	array	The list of teams associated with the Runner
type	string	A string that determines the schema of the object. This must be the standard name for the entity, suffixed by _reference if the object is a reference.

get_automation_actions_runners

Runners matching the criteria.

Name	Datatype	Description
id	string
name	string	(example: us-west-2 prod runner)
associated_actions	object	References to at most 3 actions associated with the Runner. Use appropriate endpoints to retrieve the full list of associated actions.
creation_time	string (date-time)
description	string	(example: us-west-2 runner provisioned in the production environment by the SRE team)
html_url	string (url)	a URL at which the entity is uniquely displayed in the Web app
last_seen	string (date-time)
metadata	object	Additional metadata
privileges	object
runbook_base_uri	string	The base URI of the Runbook server to connect to. May only contain alphanumeric characters, periods, underscores and dashes. (example: subdomain)
runner_type	string	sidecar -- The runner is backed by an external sidecar that polls for invocations. runbook -- The runner communicates directly with a runbook instance. (example: runbook)
self	string (url)	the API show URL at which the object is accessible
status	string	Configured -- Runner has connected to the backend at least once NotConfigured -- Runner has never connected to backend (example: Configured)
summary	string	A short-form, server-generated string that provides succinct, important information about an object suitable for primary labeling of an entity in a client. In many cases, this will be identical to name, though it is not intended to be an identifier.
teams	array	The list of teams associated with the Runner
type	string	A string that determines the schema of the object. This must be the standard name for the entity, suffixed by _reference if the object is a reference.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_automation_actions_runner	select	id	Accept, Content-Type	Get an Automation Action runner
get_automation_actions_runners	select		Accept, Content-Type, limit, cursor, name, include[]	Lists Automation Action runners matching provided query params. The returned records are sorted by runner name in alphabetical order. See Cursor-based pagination for instructions on how to paginate through the result set.
create_automation_actions_runner	insert	data__runner	Accept, Content-Type	Create a Process Automation or a Runbook Automation runner.
delete_automation_actions_runner	delete	id	Accept, Content-Type	Delete an Automation Action runner
_get_automation_actions_runners	exec		Accept, Content-Type, limit, cursor, name, include[]	Lists Automation Action runners matching provided query params. The returned records are sorted by runner name in alphabetical order. See Cursor-based pagination for instructions on how to paginate through the result set.
_get_automation_actions_runner	exec	id	Accept, Content-Type	Get an Automation Action runner
update_automation_actions_runner	exec	id, runner	Accept, Content-Type	Update an Automation Action runner

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.

Name	Datatype	Description
id	string	The ID of the resource.
Accept	string	The Accept header is used as a versioning header.
Content-Type	string
cursor	string	Optional parameter used to request the "next" set of results from an API. The value provided here is most commonly obtained from the next_cursor field of the previous request. When no value is provided, the request starts at the beginning of the result set.
include[]	array	Includes additional data elements into the response
limit	integer	The minimum of the limit parameter used in the request or the maximum request size of the API.
name	string	Filters results to include the ones matching the name (case insensitive substring matching)

SELECT examples

get_automation_actions_runner

Get an Automation Action runner

SELECT
id,
name,
associated_actions,
creation_time,
description,
html_url,
last_seen,
metadata,
privileges,
runbook_base_uri,
runner_type,
self,
status,
summary,
teams,
type
FROM pagerduty.automation_actions.runners
WHERE id = '{{ id }}' -- required
AND Accept = '{{ Accept }}'
AND Content-Type = '{{ Content-Type }}'
;

get_automation_actions_runners

Lists Automation Action runners matching provided query params.
The returned records are sorted by runner name in alphabetical order.

See Cursor-based pagination for instructions on how to paginate through the result set.

SELECT
id,
name,
associated_actions,
creation_time,
description,
html_url,
last_seen,
metadata,
privileges,
runbook_base_uri,
runner_type,
self,
status,
summary,
teams,
type
FROM pagerduty.automation_actions.runners
WHERE Accept = '{{ Accept }}'
AND Content-Type = '{{ Content-Type }}'
AND limit = '{{ limit }}'
AND cursor = '{{ cursor }}'
AND name = '{{ name }}'
AND include[] = '{{ include[] }}'
;

INSERT examples

create_automation_actions_runner

Create a Process Automation or a Runbook Automation runner.

INSERT INTO pagerduty.automation_actions.runners (
data__runner,
Accept,
Content-Type
)
SELECT 
'{{ runner }}' /* required */,
'{{ Accept }}',
'{{ Content-Type }}'
RETURNING
runner
;

Manifest

# Description fields are for documentation purposes
- name: runners
  props:
    - name: runner
      value: string
    - name: Accept
      value: string
      description: The `Accept` header is used as a versioning header.
    - name: Content-Type
      value: string

DELETE examples

delete_automation_actions_runner

Delete an Automation Action runner

DELETE FROM pagerduty.automation_actions.runners
WHERE id = '{{ id }}' --required
AND Accept = '{{ Accept }}'
AND Content-Type = '{{ Content-Type }}'
;

Lifecycle Methods

_get_automation_actions_runners

Lists Automation Action runners matching provided query params.
The returned records are sorted by runner name in alphabetical order.

See Cursor-based pagination for instructions on how to paginate through the result set.

EXEC pagerduty.automation_actions.runners._get_automation_actions_runners 
@Accept='{{ Accept }}', 
@Content-Type='{{ Content-Type }}', 
@limit='{{ limit }}', 
@cursor='{{ cursor }}', 
@name='{{ name }}', 
@include[]='{{ include[] }}'
;

_get_automation_actions_runner

Get an Automation Action runner

EXEC pagerduty.automation_actions.runners._get_automation_actions_runner 
@id='{{ id }}' --required, 
@Accept='{{ Accept }}', 
@Content-Type='{{ Content-Type }}'
;

update_automation_actions_runner

Update an Automation Action runner

EXEC pagerduty.automation_actions.runners.update_automation_actions_runner 
@id='{{ id }}' --required, 
@Accept='{{ Accept }}', 
@Content-Type='{{ Content-Type }}' 
@@json=
'{
"runner": "{{ runner }}"
}'
;