Acciones de incidentes PagerDuty

Esta página proporciona una referencia completa de las acciones de incidentes de PagerDuty disponibles en el catálogo de acciones de automatización de flujo de trabajo. Estas acciones le permiten gestionar incidentes de PagerDuty.

Requisitos previos

Antes de emplear las acciones de PagerDuty en la automatización del flujo de trabajo, cerciorar de tener lo siguiente:

Una cuenta de PagerDuty con las licencias adecuadas.
Un token de la API de PagerDuty (ya sea un token de usuario o un token de cuenta).
Las licencias necesarias para gestionar incidentes en su cuenta PagerDuty.
Para el token de cuenta, deberá proporcionar la dirección de email from en las acciones correspondientes.

Acciones

Resuelve un incidente de PagerDuty actualizando su estado a resuelto con notas de resolución opcionales.

Campo de entrada	Opcionalidad	Tipo	Ejemplo
token	Requerido	Cadena	`${{ :secrets:pagerdutyApiToken }}`
ID de incidente	Requerido	Cadena	`1234567`
tipo	Requerido	Cadena	`"incident"`
de	Opcional	Cadena	`test@example.com` El campo `from` es obligatorio para el token de cuenta, pero opcional para el token de usuario.
resolución	Opcional	Cadena	`"System is up and running and incident is resolved"`
selectores	Opcional	Lista	`[name: incidentId ,expression: .responseBody \| fromjson.incident.id]`

Campo de salida	Tipo	Ejemplo
response	objeto	`{ "incident": { "incident_number": 1233456, "title": "Example incident title1", "description": "Example incident title1", "created_at": "2025-10-14T05:30:30Z", "updated_at": "2025-10-14T05:58:53Z", "status": "resolved", .... } }`
éxito	Booleano	`success: true \| false`
mensaje de error	Cadena	`{\"incident\":{\"errors\":[\"Incident Already Resolved\"],\"id\":\"Q2TJNU161RMNBO\",\"type\":\"incident_reference\",\"summary\":\"[#4212416] Example incident`

Ejemplo de flujo de trabajo
`name: resolve-pagerduty-incident description: '' steps: - name: pagerduty_incident_resolve_1 type: action action: pagerduty.incident.resolve version: 1 inputs: token: ${{ :secrets:pagerdutyApiToken }} from: abc@example.com type: incident incidentId: Q1234567890 resolution: The incident is resolved and not action is needed next: end`

Ejemplo de flujo de trabajo

name: resolve-pagerduty-incident
description: ''
steps:
  - name: pagerduty_incident_resolve_1
    type: action
    action: pagerduty.incident.resolve
    version: 1
    inputs:
      token: ${{ :secrets:pagerdutyApiToken }}
      from: abc@example.com
      type: incident
      incidentId: Q1234567890
      resolution: The incident is resolved and not action is needed
    next: end

Recupera una lista de incidentes de PagerDuty con parámetros de filtrado opcionales como rangos de fechas y estado.

Campo de entrada	Opcionalidad	Tipo	Ejemplo
token	Requerido	Cadena	`${{ :secrets:pagerdutyApiToken }}`
parámetro	Opcional	Mapa	`{ offset: 0 , incident_key: 1234-5678-0101123 }`
selectores	Opcional	Lista	`[name: incidentId ,expression: .responseBody \| fromjson.incident.id]`

Importante

La APIdePagerDuty List admite múltiples parámetros de consulta opcionales, que se pueden gestionar de forma eficiente mediante un mapa de parámetros.

Campo de salida	Tipo	Ejemplo
response	objeto	`{ “incidents”: [ { “incident_number”: 1234, “title”: “Test Incident 1" ... } ] }`
éxito	Booleano	`success: true \| false`
mensaje de error	Cadena	`"error": { "message": "The request took too long to process.", "code": 2016 }`

Ejemplo de flujo de trabajo
`name: list-pagerduty-incidents description: '' steps: - name: pagerduty_incident_list_1 type: action action: pagerduty.incident.list version: 1 inputs: token: ${{ :secrets:pagerdutyApiToken }} parameters: since: '2025-10-14T10:30:00Z' statuses[]: 'resolved' next: end`

Ejemplo de flujo de trabajo

name: list-pagerduty-incidents
description: ''
steps:
  - name: pagerduty_incident_list_1
    type: action
    action: pagerduty.incident.list
    version: 1
    inputs:
      token: ${{ :secrets:pagerdutyApiToken }}
      parameters:
        since: '2025-10-14T10:30:00Z'
        statuses[]: 'resolved'
    next: end

Obtenga un incidente de PagerDuty.

Campo de entrada	Opcionalidad	Tipo	Ejemplo
token	Requerido	Cadena	`${{ :secrets:pagerdutyApiToken }}`
ID de incidente	Requerido	Cadena	`Q123456789`
parámetro	Opcional	Mapa	`{ include[] : “services“ }`
selectores	Opcional	Lista	`[name: incidentId ,expression: .responseBody \| fromjson.incident.id]`

Campo de salida	Tipo	Ejemplo
response	Objeto	`{ “incidents”: [ { “incident_number”: 1234, “title”: “Test Incident 1" ... } ] }`
éxito	Booleano	`success: true \| false`
mensaje de error	Cadena	`"error": { "message": "The request took too long to process.", "code": 2016 }`

Ejemplo de flujo de trabajo
`name: get-pagerduty-incident description: '' steps: - name: pagerduty_incident_get_1 type: action action: pagerduty.incident.get version: 1 inputs: token: ${{ :secrets:pagerdutyApiToken }} incidentId: Q1234455677 next: end`

Ejemplo de flujo de trabajo

name: get-pagerduty-incident
description: ''
steps:
  - name: pagerduty_incident_get_1
    type: action
    action: pagerduty.incident.get
    version: 1
    inputs:
      token: ${{ :secrets:pagerdutyApiToken }}
      incidentId: Q1234455677
    next: end

Crea un nuevo incidente en PagerDuty con el servicio, título, prioridad y otros atributos opcionales especificados.

Campo de entrada	Opcionalidad	Tipo	Ejemplo
token	Requerido	Cadena	`${{ :secrets:pagerdutyApiToken }}`
tipo	Requerido	Cadena	`"Incident"`
título	Requerido	Cadena	`"Test Incident"`
servicio	Requerido	Mapa	`"service": { "id": "PV5L94Z", "type": "service_reference" }`
de	Opcional	Cadena	`abc@example.com` El campo `from` es obligatorio para el token de cuenta, pero opcional para el token de usuario.
prioridad	Opcional	Mapa	`"priority": { "id": "P53ZZH5", "type": "priority_reference" }`
urgencia	Opcional	Cadena	`"Low"`
cuerpo	Opcional	Mapa	`"body": { "type": "incident_body", "details": "A disk is getting full on this machine. You should investigate what is causing the disk to fill, and ensure that there is an automated process in place for ensuring data is rotated (eg. logs should have logrotate around them). If data is expected to stay on this disk forever, you should start planning to scale up to a larger disk." }`
incidentKey	Opcional	Cadena	`1234-5678-919123`
tareas	Opcional	Lista	`[ { "assignee": { "id": "P11223", "type": "user_reference" } } ]`
incidentType	Opcional	Cadena	`"incident_type": { "name": "major_incident" }`
escalationPolicy	Opcional	Mapa	`"escalation_policy": { "id": "PT20YPA", "type": "escalation_policy_reference" }`
conferenceBridge	Opcional	Mapa	`"conference_bridge": { "conference_number": "+1 1234567890", "conference_url": "https://someUrl.com" }`
selectores	Opcional	Lista	`[name: incidentId ,expression: .responseBody \| fromjson.incident.id]`

Campo de salida	Tipo	Ejemplo
response	objeto	`{ "incident": { "id": "PT4KHLK", "type": "incident", "title": "The server is on fire.", .... .... }`
éxito	Booleano	`success: true \| false`
mensaje de error	Cadena	`{ "error": { "message": "Invalid Input Provided", "code": 2001, "errors": [ "Cannot specify both assignments and an escalation policy at the same time" ] } }`

Campo de salida

Tipo

Ejemplo

response

objeto

{
"incident": {
    "id": "PT4KHLK",
    "type": "incident",
    "title": "The server is on fire.",
    ....
    ....
}

éxito

Booleano

success: true | false

mensaje de error

Cadena

{
    "error": {
        "message": "Invalid Input Provided",
        "code": 2001,
        "errors": [
            "Cannot specify both assignments and an escalation policy at the same time"
        ]
    }
}

Ejemplo de flujo de trabajo
name: create-pagerduty-incident description: '' steps: - name: create type: action action: pagerduty.incident.create version: 1 inputs: token: ${{ :secrets:pagerdutyApiToken }} type: incident title: Test incident service: id: P123456 type: service_reference urgency: low body: type: incident_body details: Test Body incidentKey: a12345-b678910-c111213 escalationPolicy: id: P54321 type: escalation_policy_reference selectors: - name: incidentId expression: .responseBody \| fromjson.incident.id next: end

Ejemplo de flujo de trabajo

name: create-pagerduty-incident
description: ''
steps:
  - name: create
    type: action
    action: pagerduty.incident.create
    version: 1
    inputs:
      token: ${{ :secrets:pagerdutyApiToken }}
      type: incident
      title: Test incident 
      service:
        id: P123456
        type: service_reference
      urgency: low
      body:
        type: incident_body
        details: Test Body
      incidentKey: a12345-b678910-c111213
      escalationPolicy:
        id: P54321
        type: escalation_policy_reference
      selectors:
        - name: incidentId
          expression: .responseBody | fromjson.incident.id
    next: end

Actualiza las propiedades de un incidente de PagerDuty existente, como el estado, la prioridad, el título, las asignaciones y otros atributos.

Campo de entrada	Opcionalidad	Tipo	Ejemplo
token	Requerido	Cadena	`${{ :secrets:pagerdutyApiToken }}`
ID de incidente	Requerido	Cadena	`1234567`
de	Opcional	Cadena	`abc@example.com` El campo `from` es obligatorio para el token de cuenta, pero opcional para el token de usuario.
tipo	Requerido	Cadena	`"incident"`
estado	Opcional	Cadena	`"acknowledged"`
prioridad	Opcional	Mapa	`"priority": { "id": "P53ZZH5", "type": "priority_reference" }`
título	Opcional	Cadena	`"Test Incident 2"`
escalation_level	Opcional	Entero	`1`
tareas	Opcional	Lista	`[ { "assignee": { "id": "P11223", "type": "user_reference" } } ]`
incident_type	Opcional	Mapa	`"incident_type": { "name": "major_incident" }`
escalation_policy	Opcional	Mapa	`"escalation_policy": { "id": "PT20YPA", "type": "escalation_policy_reference" }`
urgencia	Opcional	Cadena	`"low" or "high"`
conference_bridge	Opcional	Mapa	`"conference_bridge": { "conference_number": "+1 1234567890", "conference_url": "https://someUrl.com" }`
servicio	Opcional	Mapa	`"service": { "id": "PV5L94Z", "type": "service_reference" }`
resolución	Opcional	Cadena	`"resolved"`
selectores	Opcional	Lista	`[name: incidentId ,expression: .responseBody \| fromjson.incident.id]`

Campo de salida	Tipo	Ejemplo
response	Objeto	`{ "incident": { "id": "PT4KHLK", "type": "incident", "title": "The server is on fire.", .... .... }`
éxito	Booleano	`success: true \| false`
mensaje de error	Cadena

Ejemplo de flujo de trabajo
`name: update-pagerduty-incident description: '' steps: - name: pagerduty_incident_update_1 type: action action: pagerduty.incident.update version: 1 inputs: token: ${{ :secrets:pagerdutyApiToken }} type: incident incidentId: Q1234567890123 status: acknowledged title: Incident Title Updated urgency: low service: id: P123456 type: service_reference conferenceBridge: conference_number: '+1 1234567890' conference_url: test@example.com next: end`

Ejemplo de flujo de trabajo

name: update-pagerduty-incident
description: ''
steps:
  - name: pagerduty_incident_update_1
    type: action
    action: pagerduty.incident.update
    version: 1
    inputs:
      token: ${{ :secrets:pagerdutyApiToken }}
      type: incident
      incidentId: Q1234567890123
      status: acknowledged
      title: Incident Title Updated
      urgency: low
      service:
        id: P123456
        type: service_reference
      conferenceBridge:
        conference_number: '+1 1234567890'
        conference_url: test@example.com
    next: end

Te ofrecemos esta traducción automática para facilitar la lectura.

Requisitos previos

Acciones

Resolver un incidente de PagerDuty

Lista PagerDuty

Importante

Reciba un incidente de PagerDuty

Crea un nuevo incidente de PagerDuty

Actualizar un incidente de PagerDuty

Te ofrecemos esta traducción automática para facilitar la lectura.

Acciones de incidentes PagerDuty

Requisitos previos.css-21sua1{background:none;border:none;width:0;padding:0;}

Acciones

Lista PagerDuty

Reciba un incidente de PagerDuty

Crea un nuevo incidente de PagerDuty

Actualizar un incidente de PagerDuty

Requisitos previos