workflow : activateAndWait

Espace de noms : microsoft.graph.identityGovernance

Activez un workflow de cycle de vie pour un sujet spécifié et attendez de façon synchrone la fin de l’exécution. Cette action retourne un awaitedWorkflowProcessingResult avec le résultat de l’exécution. Utilisez cette action lorsque vous avez besoin d’une confirmation immédiate de l’achèvement du flux de travail, par exemple lors de l’approvisionnement d’un sujet non-utilisateur.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire) LifecycleWorkflows-Workflow.Activate LifecycleWorkflows-Workflow.ReadWrite.All, LifecycleWorkflows.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application LifecycleWorkflows-Workflow.Activate LifecycleWorkflows-Workflow.ReadWrite.All, LifecycleWorkflows.ReadWrite.All

Requête HTTP

POST /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/activateAndWait

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON des paramètres.

Le tableau suivant répertorie les paramètres qui sont requis lorsque vous appelez cette action.

Paramètre Type Description
sujet microsoft.graph.identityGovernance.workflowSubject Objet pour lequel activer le flux de travail. Doit inclure la @odata.type propriété pour spécifier le type dérivé (par exemple, #microsoft.graph.identityGovernance.provisioningObjectWorkflowSubject). Obligatoire.

Réponse

En cas de succès, cette action retourne un 200 OK code de réponse et un awaitedWorkflowProcessingResult dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/v1.0/identityGovernance/lifecycleWorkflows/workflows/14879a93-6b91-4153-b7e6-5df4a7b7c5c8/activateAndWait
Content-Type: application/json

{
  "subject": {
    "@odata.type": "#microsoft.graph.identityGovernance.provisioningObjectWorkflowSubject",
    "id": "b74f0fae-b1f3-4c96-9bf0-d4d8a8e37cbe",
    "attributeSetEntries": [
      {
        "name": "department",
        "value": "Engineering"
      },
      {
        "name": "jobTitle",
        "value": "Software Engineer"
      }
    ]
  }
}

Réponse

L’exemple suivant illustre la réponse.

Remarque

L’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.identityGovernance.awaitedWorkflowProcessingResult",
  "processingStatus": "completed",
  "statusReasons": [],
  "subject": {
    "@odata.type": "#microsoft.graph.identityGovernance.provisioningObjectWorkflowSubject",
    "id": "b74f0fae-b1f3-4c96-9bf0-d4d8a8e37cbe",
    "attributeSetEntries": [
      {
        "name": "department",
        "value": "Engineering"
      },
      {
        "name": "jobTitle",
        "value": "Software Engineer"
      }
    ]
  }
}
  • Last updated on