Partager via


Mettre à jour approvalStage

Espace de noms: microsoft.graph

Approuver ou refuser un objet approvalStage dans une approbation.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Autorisations requises pour appeler cette API pour la gestion des droits d’utilisation

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) EntitlementManagement.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application Non prise en charge.

Autorisations requises pour appeler cette API pour PIM pour les groupes

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup
Déléguée (compte Microsoft personnel) Non prise en charge.
Application Non prise en charge.

Requête HTTP

Pour mettre à jour une décision d’approbation dans la gestion des droits d’utilisation :

PATCH /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/{accessPackageAssignmentRequestId}/stages/{approvalStageId}

Pour mettre à jour une décision d’approbation dans PIM pour les groupes :

PATCH /identityGovernance/privilegedAccess/group/assignmentApprovals/{privilegedaccessgroupassignmentschedulerequestId}/stages/{approvalStageId}

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

Corps de la demande

Le tableau suivant présente les propriétés requises pour cette méthode.

Propriété Type Description
reviewResult Chaîne Décision de l’approbateur. Les valeurs possibles sont les suivantes : Approve, Deny. Obligatoire.
Justification Chaîne Justification liée à la décision de l’approbateur.

Réponse

Si elle réussit, cette méthode renvoie un 204 No Content code de réponse dans le corps de la réponse. Si l’appelant ne dispose pas des autorisations appropriées, la méthode retourne un 403 Forbidden code de réponse ou, si l’ID d’approbation est introuvable, la méthode retourne 404 Not found. Si la demande a déjà été approuvée par un autre approbateur dans la même étape d’approbation, la méthode retourne 409 Conflict le code de réponse.

Exemples

Demande

PATCH https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/abd306ef-f7b2-4a10-9fd1-493454322489/stages/d4fa4045-4716-436d-aec5-57b0a713f095

{
 "reviewResult":"Approve",
 "justification":"OK"
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content