Skip to content

pagerduty list-on-calls

List the on-call entries.

Description

List the on-call entries during a given time range.

Synopsis

pagerduty list-on-calls
    --site <site>
    [--limit <limit>]
    [--since <since>]
    [--until <until>]

Arguments

site - (string)

     Site where this command will be executed
     Example: --site "site-1"
     Default: input.site      Attributes: required

limit - (int)

     The number of results per page.
     Example: --limit 10
     Default: 25      Attributes: optional

since - (time)

     The start of the date range over which you want to search. Maximum range is 6 months and default is 1 month.
     Example: --since "1 month ago"
     Default: 1 month ago      Attributes: optional

until - (time)

     The end of the date range over which you want to search. Maximum range is 6 months and default is 1 month.
     Example: --until "now"
     Default: now      Attributes: optional

Examples

pagerduty list-on-calls

Access Control

To use this command, you need access to the following:

Field Value
Action "read"
Service Type "pagerduty"
Service Instance
Namespace
Object Type "on-calls"
Object ID

Please see Access Control for details.