Tools do PagerDuty
As 12 operações do PagerDuty que o seu produto executa na conta do cliente pelo Connect. Todas usam o mesmo endpoint, POST /api/tools/{tool}/execute.
- Listar incidentesGETLista os incidentes da conta criados no último mês, ou no intervalo de since e until. Não há filtro por status, serviço ou responsável aqui, então leia status, service e assignments em cada item. Pagine com limit e offset enquanto more for true.
- Obter incidenteGETRetorna um incidente com status, urgência, prioridade, serviço, atribuições, reconhecimentos e política de escalonamento.
- Criar incidentePOSTCria um incidente em um serviço, o que notifica a política de escalonamento do serviço ou os usuários em assignments. Precisa de type, title e service. Envie assignments ou escalation_policy, nunca os dois. Um incidente que o usuário atribui a si mesmo começa reconhecido, sem notificá-lo.
- Atualizar incidentePUTReconhece, resolve, reatribui ou escala um incidente, ou muda seu título, urgência, prioridade ou serviço. Envie type e só os campos a mudar. Reatribuir ou escalar notifica os novos responsáveis, e definir status em um incidente resolvido o reabre.
- Listar notas do incidenteGETLista as notas de um incidente, cada uma com seu conteúdo, autor e hora de criação.
- Criar nota no incidentePOSTAdiciona uma nota a um incidente, assinada pelo usuário da conexão. Um incidente comporta até 2000 notas.
- Listar entradas de log do incidenteGETLista a linha do tempo de um incidente: acionamentos, notificações, reconhecimentos, atribuições, escalonamentos, notas e resolução, cada um com o agente e a hora. Pagine com limit e offset enquanto more for true.
- Listar serviçosGETLista os serviços da conta, cada um com id, nome, status e política de escalonamento. O id é o que Create incident e Update incident pedem. Pagine com limit e offset enquanto more for true.
- Listar plantõesGETLista quem está de plantão, uma entrada por usuário, política de escalonamento e nível, com a escala quando o turno vem de uma. Sem since e until, retorna os plantões de agora. Pagine com limit e offset enquanto more for true.
- Listar usuáriosGETLista os usuários da conta, com id, nome, e-mail e função. O id vai no assignee de Create incident e Update incident. Pagine com limit e offset enquanto more for true.
- Listar políticas de escalonamentoGETLista as políticas de escalonamento da conta, cada uma com id, nome e regras de escalonamento. O id vai no escalation_policy de Create incident e Update incident. Pagine com limit e offset enquanto more for true.
- Listar prioridadesGETLista as prioridades de incidente da conta, da mais à menos grave, como P1 a P5. O id vai no priority de Create incident e Update incident. Uma conta que não configurou prioridades não tem nenhuma.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
