Compartilhar via


Visão geral da API de relatório do fluxo de trabalho do ciclo de vida

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Os fluxos de trabalho do ciclo de vida oferecem relatórios que permitem que as organizações obtenham informações sobre como os fluxos de trabalho do ciclo de vida foram processados para usuários em sua organização.

Observação

Este artigo descreve como exportar dados pessoais de um dispositivo ou serviço. Essas etapas podem ser usadas para dar suporte às suas obrigações de acordo com o GDPR (Regulamento Geral de Proteção de Dados). Os administradores de locatários autorizados podem usar o Microsoft Graph para corrigir, atualizar ou excluir informações identificáveis sobre usuários finais, incluindo perfis de usuário de clientes e funcionários ou dados pessoais, como nome do usuário, título de trabalho, endereço ou número de telefone, em seu ambiente Microsoft Entra ID.

A API de fluxos de trabalho do ciclo de vida é definida no subnamespace OData, microsoft.graph.identityGovernance.

Elementos-chave dos relatórios de fluxos de trabalho do ciclo de vida

Recurso de relatório Descrição
Resultado do processamento do usuário Resultado de um fluxo de trabalho do ciclo de vida que foi executado para um usuário específico. O resultado é uma agregação de todos os resultados de processamento de tarefas das tarefas de fluxo de trabalho que faziam parte do fluxo de trabalho do ciclo de vida e executadas para o usuário específico.
Resultado do processamento de tarefas Resultado de uma tarefa de fluxo de trabalho que foi executada para um usuário específico.
Execução do fluxo de trabalho Resultado de um fluxo de trabalho do ciclo de vida que foi executado para uma coleção de usuários. O resultado é uma agregação de todos os resultados de processamento de usuários dos usuários que foram processados em um intervalo ou fizeram parte de uma execução sob demanda.
Relatório de tarefas Uma agregação de resultados de processamento de tarefas para uma tarefa de fluxo de trabalho específica em uma execução de fluxo de trabalho. Com este relatório, o status de integridade de uma tarefa de fluxo de trabalho dentro de uma execução de fluxo de trabalho pode ser facilmente determinado e, portanto, a fonte de erro pode ser identificada mais rapidamente caso uma execução de fluxo de trabalho falhe.

Fluxos de trabalho do ciclo de vida em logs de auditoria

Todos os eventos executados nos fluxos de trabalho do ciclo de vida são registrados por Microsoft Entra ID. Isso inclui criar, atualizar, excluir ou executar fluxos de trabalho e atribuir permissões a aplicativos.

Esses logs auditáveis são representados pelo tipo de recurso directoryAudit e seus métodos GET associados no Microsoft Graph.

Verificações de licença

Usar esse recurso requer licenças de Microsoft Entra ID Governance. Para encontrar a licença certa para seus requisitos, consulte Comparar recursos geralmente disponíveis do Micorosft Microsoft Entra ID.

Verificações de autorização de função e de aplicativo

As funções de Microsoft Entra a seguir são necessárias para um usuário chamado ler relatórios em fluxos de trabalho do ciclo de vida.

Operação Permissões de aplicativos Função de diretório necessária do usuário de chamada
Leitura Ciclo de vidaWorkflows.Read.All ou LifecycleWorkflows.ReadWrite.All Administrador global de fluxos de trabalho do leitor ou ciclo de vida
Criar, Atualizar ou Excluir LifecycleWorkflows.ReadWrite.All Administrador de fluxos de trabalho do ciclo de vida