counts
Creates, updates, deletes, gets or lists a counts resource.
Overview
| Name | counts |
| Type | Resource |
| Id | pagerduty.paused_incident_reports.counts |
Fields
The following fields are returned by SELECT queries:
- get
Paused Incident Reporting counts for the Account or scoped to a Service.
| Name | Datatype | Description |
|---|---|---|
paused_count | number | The total number of paused Alerts for the Account or Servce. |
resolved_after_pause_count | number | The total number of paused Alerts for the Account or Service that were resolved after being paused and not triggered (transient Alerts). |
since | string | The start of the date range over which the report data is represented. |
triggered_after_pause_count | number | The total number of paused Alerts for the Account or Service that were triggerd after being paused (non-transient Alerts). |
until | string | The end of the date range over which the report data is represented. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | since, until, service_id, suspended_by | Returns reporting counts for paused Incident usage for a given reporting period (maximum 6 months lookback period). Note: This feature is currently available as part of the Event Intelligence package or Digital Operations plan only.<br /><br />For more information see the [API Concepts Document](https://developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#paused-incident-reports)<br /><br />Scoped OAuth requires: incidents.read<br /> |
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 |
|---|---|---|
service_id | string | Specifies a filter to limit the scope of reporting to a particular service |
since | string (date-time) | The start of the date range over which you want to search. |
suspended_by | | Specifies a filter to scope the response to either alerts suspended by Auto Pause or Event Rules. |
until | string (date-time) | The end of the date range over which you want to search. |
SELECT examples
- get
Returns reporting counts for paused Incident usage for a given reporting period (maximum 6 months lookback period). Note: This feature is currently available as part of the Event Intelligence package or Digital Operations plan only.<br /><br />For more information see the [API Concepts Document](https://developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#paused-incident-reports)<br /><br />Scoped OAuth requires: incidents.read<br />
SELECT
paused_count,
resolved_after_pause_count,
since,
triggered_after_pause_count,
until
FROM pagerduty.paused_incident_reports.counts
WHERE since = '{{ since }}'
AND until = '{{ until }}'
AND service_id = '{{ service_id }}'
AND suspended_by = '{{ suspended_by }}'
;