PagerDuty (versión preliminar)
PagerDuty es una plataforma ágil de administración de incidentes que se integra con las pilas de supervisión de operaciones de TI y DevOps para mejorar la confiabilidad operativa y la agilidad de las organizaciones.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Estándar | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL |
Compatibilidad con Microsoft LogicApps Soporte técnico de Microsoft Power Automate Soporte técnico de Microsoft Power Apps |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://www.pagerduty.com/ |
| Directiva de privacidad | https://www.pagerduty.com/privacy-policy/ |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API PagerDuty | securestring | Clave de API PagerDuty | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 30 | 60 segundos |
| Frecuencia de sondeos de desencadenador | 1 | 30 segundos |
Acciones
| Agregar nota al incidente |
Agregue una nota a un incidente determinado. |
| Confirmación del incidente |
Confirme un incidente determinado. |
| Creación de incidentes |
Crea un nuevo incidente para un servicio determinado identificable por la clave de integración. |
| Escalado de incidentes |
Use una directiva de escalación determinada en un incidente. |
| Obtención del usuario por identificador |
Recupera la información del usuario para un identificador determinado. |
| Obtener incidente |
Recupera el objeto incident por clave de incidente. |
| Posponer incidente |
Posponer un incidente determinado en un momento determinado. |
| Reasignar incidente |
Reasignar un incidente determinado. |
| Resolución de incidentes |
Marque un incidente determinado como resuelto. |
Agregar nota al incidente
Agregue una nota a un incidente determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Incidente
|
incidentId | True | string |
Selección de un incidente |
|
Agregado por
|
userId | True | string |
Selección de un usuario |
|
Nota:
|
note | True | string |
Texto de la nota |
Devoluciones
Respuesta al punto de conexión addNoteToIncident
- Body
- AddNoteResponse
Confirmación del incidente
Confirme un incidente determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Incidente
|
incidentId | True | string |
Selección de un incidente |
|
Confirmado por
|
userId | True | string |
Selección de un usuario |
Devoluciones
Un incidente con la propia propiedad incident
- Body
- SingleIncident
Creación de incidentes
Crea un nuevo incidente para un servicio determinado identificable por la clave de integración.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Clave de servicio
|
service_key | True | string |
Clave de integración del servicio de PagerDuty |
|
Description
|
description | True | string |
Descripción del incidente |
Devoluciones
Un nuevo incidente
- Body
- NewIncident
Escalado de incidentes
Use una directiva de escalación determinada en un incidente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Incidente
|
incidentId | True | string |
Selección de un incidente |
|
Escalado por
|
userId | True | string |
Selección de un usuario |
|
Directiva de escalación
|
policyId | True | string |
Selección de una directiva |
Devoluciones
Un incidente con la propia propiedad incident
- Body
- SingleIncident
Obtención del usuario por identificador
Recupera la información del usuario para un identificador determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
ID de usuario
|
userId | True | string |
Identificador único del usuario. |
Devoluciones
Un usuario PagerDuty
- Body
- User
Obtener incidente
Recupera el objeto incident por clave de incidente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Incidente
|
incident_key | True | string |
Clave de incidente |
Devoluciones
Un incidente
- Body
- Incident
Posponer incidente
Posponer un incidente determinado en un momento determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Incidente
|
incidentId | True | string |
Selección de un incidente |
|
Posponedo por
|
userId | True | string |
Selección de un usuario |
|
Dormitar
|
duration | True | integer |
Cantidad de tiempo, en segundos, para posponer el incidente |
Devoluciones
Un incidente con la propia propiedad incident
- Body
- SingleIncident
Reasignar incidente
Reasignar un incidente determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Incidente
|
incidentId | True | string |
Selección de un incidente |
|
Usuario remitente
|
userId | True | string |
Selección de un usuario |
|
Para el usuario
|
reassignUserId | True | string |
Selección de un usuario |
Devoluciones
Un incidente con la propia propiedad incident
- Body
- SingleIncident
Resolución de incidentes
Marque un incidente determinado como resuelto.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Incidente
|
incidentId | True | string |
Selección de un incidente |
|
Resuelto por
|
userId | True | string |
Selección de un usuario |
Devoluciones
Un incidente con la propia propiedad incident
- Body
- SingleIncident
Desencadenadores
| Cuando se agrega una nota |
Se desencadena cuando se agrega una nota al incidente determinado. |
| Cuando se asigna un incidente a un usuario |
Se desencadena cuando se asigna un incidente al usuario determinado. |
| Cuando se confirma un incidente |
Se desencadena cuando se confirma un incidente existente. |
| Cuando se crea un incidente |
Se desencadena cuando se crea un nuevo incidente. |
| Cuando se resuelve un incidente |
Se desencadena cuando se resuelve un incidente existente. |
Cuando se agrega una nota
Se desencadena cuando se agrega una nota al incidente determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Incidente
|
incidentId | True | string |
Selección de un incidente |
Devoluciones
Objeto response para notas
- Body
- NotesResponse
Cuando se asigna un incidente a un usuario
Se desencadena cuando se asigna un incidente al usuario determinado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Usuario
|
userId | True | string |
Selección de un usuario |
Devoluciones
Respuesta para obtener una lista de incidentes
- Body
- IncidentsResponse
Cuando se confirma un incidente
Se desencadena cuando se confirma un incidente existente.
Devoluciones
Respuesta para obtener una lista de incidentes
- Body
- IncidentsResponse
Cuando se crea un incidente
Se desencadena cuando se crea un nuevo incidente.
Devoluciones
Respuesta para obtener una lista de incidentes
- Body
- IncidentsResponse
Cuando se resuelve un incidente
Se desencadena cuando se resuelve un incidente existente.
Devoluciones
Respuesta para obtener una lista de incidentes
- Body
- IncidentsResponse
Definiciones
IncidentsResponse
Respuesta para obtener una lista de incidentes
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Lista de incidentes
|
incidents | array of Incident |
Lista de incidentes |
SingleIncident
Un incidente con la propia propiedad incident
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
incidente
|
incident | Incident |
Un incidente |
Incidente
Un incidente
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificación del incidente
|
id | string |
Identificación del incidente |
|
Título del incidente
|
summary | string |
Título del incidente |
|
Dirección URL de detalles del incidente
|
html_url | string |
Dirección URL de detalles del incidente |
|
Fecha de creación
|
created_at | string |
Fecha de creación |
|
Estado actual
|
status | string |
Estado actual |
|
Clave de incidente
|
incident_key | string |
Clave de incidente |
|
servicio
|
service | Service |
Un servicio |
|
Id. de usuario asignado
|
assignedUserId | string |
El identificador del usuario asignado a este incidente |
|
Último cambio de estado
|
last_status_change_at | string |
Último cambio de estado |
|
last_status_change_by
|
last_status_change_by | LastStatusChangeBy |
Representa el usuario o servicio que cambió por última vez un incidente. |
|
first_trigger_log_entry
|
first_trigger_log_entry | FirstTriggerLogEntry |
Entrada de registro para cuando se desencadena un incidente |
|
escalation_policy
|
escalation_policy | EscalationPolicy |
Directiva en vigor para escalar un incidente |
|
Urgencia actual
|
urgency | string |
Urgencia actual |
NewIncident
Un nuevo incidente
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Key
|
incident_key | string |
Key |
Service
Un servicio
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de servicio
|
id | string |
Id. de servicio |
LastStatusChangeBy
Representa el usuario o servicio que cambió por última vez un incidente.
FirstTriggerLogEntry
Entrada de registro para cuando se desencadena un incidente
EscalationPolicy
Directiva en vigor para escalar un incidente
Objeto
Usuario
Un usuario PagerDuty
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre
|
name | string |
Nombre |
|
Dirección de correo electrónico
|
string |
Dirección de correo electrónico |
|
|
Nombre de zona horaria preferido. Si es null, se usará la zona horaria de la cuenta.
|
time_zone | string |
Nombre de zona horaria preferido. Si es null, se usará la zona horaria de la cuenta. |
|
Se factura al usuario
|
billed | boolean |
Se factura al usuario |
|
Rol de usuario
|
role | string |
Rol de usuario |
|
Description
|
description | string |
Bio del usuario |
|
Métodos de contacto para el usuario
|
contact_methods | array of ContactMethod |
Métodos de contacto para el usuario |
|
Reglas de notificación para el usuario
|
notification_rules | array of NotificationRule |
Reglas de notificación para el usuario |
|
Puesto
|
job_title | string |
Título del trabajo del usuario |
|
Teams al que pertenece el usuario
|
teams | array of Object |
Teams al que pertenece el usuario |
|
Lista de incidentes para este usuario
|
coordinated_incidents | array of Object |
Lista de incidentes para este usuario |
|
ID de usuario
|
id | string |
ID de usuario |
|
Dirección URL en la que la entidad se muestra de forma única en la aplicación web
|
html_url | string |
Dirección URL en la que la entidad se muestra de forma única en la aplicación web |
ContactMethod
Método para contacto
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
HTML URL
|
html_url | string |
Dirección URL en la que la entidad se muestra de forma única en la aplicación web |
NotificationRule
Regla de notificación
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
HTML URL
|
html_url | string |
Dirección URL en la que la entidad se muestra de forma única en la aplicación web |
NotesResponse
Objeto response para notas
AddNoteResponse
Respuesta al punto de conexión addNoteToIncident
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
user
|
user | UserResponse |
Respuesta del usuario |
|
nota
|
note | NoteResponse |
Respuesta de nota |
UserResponse
Respuesta del usuario
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
ID de usuario
|
id | string |
ID de usuario |
NotaResponse
Respuesta de nota
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador único del usuario
|
id | string |
Identificador único del usuario |
|
user
|
user | UserResponse |
Respuesta del usuario |
|
Contenido de la nota
|
content | string |
Contenido de la nota |
|
Fecha y hora en que se creó la nota
|
created_at | string |
Fecha y hora en que se creó la nota |