Acciones de incidentes PagerDuty

avance

Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!

Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras políticas de prelanzamiento.

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.

avance

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

avance

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