Lists approvalSteps

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Répertorier les objets approvalStep associés à une approbation. Cette demande d’API est effectuée par un approbateur dans les scénarios suivants :

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

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet
✅ ✅ ✅ ✅

Autorisations

Les tableaux suivants indiquent la ou les autorisations les moins privilégiées requises pour appeler cette API sur chaque type de ressource pris en charge. Suivez les bonnes pratiques pour demander les autorisations les moins privilégiées. 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.

Pour la gestion des droits d’utilisation

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

Conseil

Pour l’accès délégué à l’aide de comptes professionnels ou scolaires, l’utilisateur connecté doit disposer d’un rôle d’administrateur avec des autorisations de rôle prises en charge via l’une des options suivantes :

  • Un rôle dans le système de gestion des droits d’utilisation où les rôles les moins privilégiés sont :
    • Lecteur de catalogue. Il s’agit de l’option la moins privilégiée
    • Créateur de catalogue
    • Gestionnaire de package d’accès
  • Rôles Microsoft Entra plus privilégiés pris en charge pour cette opération :
    • Lecteur de sécurité
    • Lecteur général
    • Administrateur de conformité
    • Administrateur de sécurité
    • Administrateur de gouvernance des identités

Dans les scénarios d’application uniquement, l’application appelante peut se voir attribuer l’un des rôles pris en charge précédents au lieu de l’autorisation d’application EntitlementManagement.Read.All . Le rôle de lecteur de catalogue est moins privilégié que l’autorisation de l’application EntitlementManagement.Read.All .

Pour plus d’informations, voir Délégation et rôles dans la gestion des droits d’utilisation et comment déléguer la gouvernance des accès aux gestionnaires de packages d’accès dans la gestion des droits d’utilisation.

Pour PIM pour les rôles de Microsoft Entra

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

Pour PIM pour les groupes

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

Requête HTTP

Pour répertorier les étapes d’approbation dans la gestion des droits d’utilisation :

GET /identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/{id}/steps

Pour répertorier les étapes d’approbation dans PIM pour les rôles Microsoft Entra :

GET /roleManagement/directory/roleAssignmentApprovals/{id}/steps

Pour répertorier les étapes d’approbation dans PIM pour les groupes :

GET /identityGovernance/privilegedAccess/group/assignmentApprovals/{id}/steps

En-têtes de demande

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

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

En cas de réussite, cette méthode renvoie un 200 OK code de réponse et une collection des objets approvalStep dans le corps de la réponse. Toutefois, si l’appelant ne dispose pas des autorisations appropriées, la méthode renvoie un 403 Forbidden code de réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentApprovals/abd306ef-f7b2-4a10-9fd1-493454322489/steps

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

{
    "value": [
        {
            "id": "d4fa4045-4716-436d-aec5-57b0a713f095",
            "displayName": null,
            "reviewedDateTime": null,
            "reviewResult": "NotReviewed",
            "status": "InProgress",
            "assignedToMe": true,
            "justification": "",
            "reviewedBy": null
        }
    ]
}
  • Dernière mise à jour :