Listar workflowVersions
Namespace: microsoft.graph.identityGovernance
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.
Obtenha uma lista dos objetos workflowVersion e suas propriedades.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | Ciclo de vidaWorkflows.Read.All | LifecycleWorkflows.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Ciclo de vidaWorkflows.Read.All | LifecycleWorkflows.ReadWrite.All |
Para cenários delegados, o administrador precisa, pelo menos, da função Administrador de Fluxos de Vida ou Leitor GlobalMicrosoft Entra.
Solicitação HTTP
GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/versions
Parâmetros de consulta opcionais
Esse método dá suporte aos $select
parâmetros de consulta , $count
, $search
, $orderby
, $expand
e $filter
OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK
código de resposta e uma coleção de objetos microsoft.graph.identityGovernance.workflowVersion no corpo da resposta.
Exemplos
Exemplo 1: recuperar as versões de um fluxo de trabalho
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/156ce798-1eb6-4e0a-8515-e79f54d04390/versions
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows('156ce798-1eb6-4e0a-8515-e79f54d04390')/versions",
"value": [
{
"category": "joiner",
"description": "Configure new hire tasks for onboarding employees on their first day",
"displayName": "Global onboard new hire employee",
"isEnabled": true,
"isSchedulingEnabled": true,
"lastModifiedDateTime": "2022-08-24T19:33:03.8664941Z",
"versionNumber": 3,
"createdDateTime": "2022-08-24T19:31:33.5534766Z"
},
{
"category": "joiner",
"description": "Configure new hire tasks for onboarding employees on their first day",
"displayName": "Onboard new hire employee",
"isEnabled": true,
"isSchedulingEnabled": false,
"lastModifiedDateTime": "2022-08-24T19:31:33.4303233Z",
"versionNumber": 2,
"createdDateTime": "2022-08-24T19:18:18.6841471Z"
},
{
"category": "joiner",
"description": "Configure new hire tasks for onboarding employees on their first day",
"displayName": "Onboard new hire employee",
"isEnabled": true,
"isSchedulingEnabled": false,
"lastModifiedDateTime": "2022-08-24T19:18:18.5633638Z",
"versionNumber": 1,
"createdDateTime": "2022-08-24T15:39:17.6496784Z"
}
]
}
Exemplo 2: recuperar propriedades específicas de todas as versões de um fluxo de trabalho
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows/15239232-66ed-445b-8292-2f5bbb2eb833/versions?$select=category,displayName,versionNumber
Resposta
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/workflows('15239232-66ed-445b-8292-2f5bbb2eb833')/versions(category,displayName,versionNumber)",
"value": [
{
"category": "leaver",
"displayName": "Post-Offboarding of an employee",
"versionNumber": 2
},
{
"category": "leaver",
"displayName": "Post-Offboarding of an employee",
"versionNumber": 1
}
]
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de