type de ressource unifiedRoot

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 .

Ressource de conteneur qui regroupe les collections de révision d’accès unifiées sous le segment de chemin d’accès identityGovernance/accessReviews/unified . La unified voie est le point d’entrée pour les révisions d’accès centrées sur l’utilisateur (étendue du catalogue), où un administrateur examine l’accès d’un utilisateur à toutes les ressources contenues dans un catalogue de gestion des droits d’utilisation en une seule révision, plutôt que d’examiner une ressource à la fois.

Un catalogue est un conteneur qui regroupe plusieurs types de ressources (actuellement les groupes et les applications). Avec une révision centrée sur l’utilisateur, un réviseur (généralement le responsable de l’utilisateur) évalue l’accès d’un principal à chaque groupe et application du catalogue à partir d’une vue unique et consolidée. Les collections réutilisent les mêmes formes de ressource accessReviewScheduleDefinition, accessReviewInstance et accessReviewInstanceDecisionItem que l’API de révisions d’accès généralement disponible ; l’étendue du catalogue est exprimée par le principalResourceMembershipsScope de la définition de révision.

Cette ressource est accessible par la relation unifiée sur la ressource accessReviewSet .

Le tableau suivant récapitule les différences entre la route unifiée et l’API de révisions d’accès actuelle.

Aspect Révisions d’accès actuelles (accessReviews) Révisions d’accès unifiées (accessReviews/unified)
Focus sur la révision examine une seule ressource à la fois (un groupe, une application, un rôle d’annuaire ou un package d’accès). Centré sur l’utilisateur : examine l’accès d’un principal dans tous les groupes et applications d’un catalogue en une seule révision.
Modèle d’étendue En règle générale, un accessReviewQueryScope ciblant une ressource. A principalResourceMembershipsScope avec une étendue de ressource de scopeType: catalog.
Routage Adressé sous identityGovernance/accessReviews. Adressé sous identityGovernance/accessReviews/unified. Le segment de chemin d’accès est auto-descriptif, détectable dans les métadonnées et fonctionne avec les SDK Microsoft Graph et Graph Explorer.

Hérite de l’entité.

Méthodes

Méthode Type de retour Description
Définitions de liste collection accessReviewScheduleDefinition Récupérez les objets accessReviewScheduleDefinition centrés sur l’utilisateur (portée du catalogue) par le biais de l’itinéraire unifié.
Créer une définition accessReviewScheduleDefinition Créez un objet accessReviewScheduleDefinition centré sur l’utilisateur (portée du catalogue) via l’itinéraire unifié.

Seules la liste et la création de définitions sont documentées en tant que méthodes unifiées dédiées, car la création d’une révision d’étendue de catalogue est la seule opération spécifique à l’itinéraire unifié. Une fois qu’une définition est créée, ses instances, ses étapes et ses décisions sont gérées par les opérations partagées accessReviewScheduleDefinition, accessReviewInstance et accessReviewInstanceDecisionItem (par exemple, obtenir, mettre à jour, supprimer, répertorier les instances, arrêter et appliquer des décisions), traitées sous le segment de identityGovernance/accessReviews/unified chemin. La section Exemples montre ces opérations partagées par rapport au chemin unifié et des liens vers les pages de méthodes correspondantes.

Propriétés

Aucune.

Relations

Relation Type Description
décisions collection accessReviewInstanceDecisionItem Représente les décisions unifiées (vNext) de révision d’accès sur une instance d’une révision.
définitions collection accessReviewScheduleDefinition Représente le modèle unifié (vNext) et la planification d’une révision d’accès.
instances collection accessReviewInstance Représente l’instance unifiée (vNext) d’une révision.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.unifiedRoot"
}

Exemples

La création et la liste de définitions centrées sur l’utilisateur (portée du catalogue) sont documentées sur les pages de méthode, Lister les définitions et Créer une définition. Les exemples suivants montrent comment naviguer dans les instances et les décisions d’une définition et appliquer les résultats via l’itinéraire unified . Chaque demande est traitée sous le segment de identityGovernance/accessReviews/unified chemin.

Exemple 1 : répertorier les instances d’une définition de révision d’accès unifiée

L’exemple suivant répertorie les objets accessReviewInstance pour une définition centrée sur l’utilisateur. Pour obtenir des exemples de code dans les SDK Microsoft Graph, consultez Liste des instances.

Demande

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances

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/beta/$metadata#identityGovernance/accessReviews/unified/definitions('29f2d16e-9ca6-4052-bbfe-802c48944448')/instances",
    "value": [
        {
            "id": "e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f",
            "status": "InProgress",
            "startDateTime": "2026-08-31T00:00:00Z",
            "endDateTime": "2026-09-06T00:00:00Z"
        }
    ]
}

Exemple 2 : répertorier les principaux en cours d’examen pour une instance

L’exemple suivant regroupe les objets accessReviewInstanceDecisionItem par principal pour renvoyer les utilisateurs distincts dont l’accès est en cours d’examen dans l’instance. Pour obtenir des exemples de code dans les SDK Microsoft Graph, consultez Lister les décisions.

Demande

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances/e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f/decisions?$apply=groupby((principal/id,principal/displayName))

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/beta/$metadata#identityGovernance/accessReviews/unified/definitions('29f2d16e-9ca6-4052-bbfe-802c48944448')/instances('e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f')/decisions",
    "value": [
        {
            "principal": {
                "id": "a4c6f1e2-6f2d-4b8a-9c3e-2f1a0b5d7e9c",
                "displayName": "Alex Wilber"
            }
        }
    ]
}

Exemple 3 : Décisions de liste pour une instance

L’exemple suivant répertorie les objets accessReviewInstanceDecisionItem individuels (un par principal et ressource) pour une instance de révision centrée sur l’utilisateur. Pour obtenir des exemples de code dans les SDK Microsoft Graph, consultez Lister les décisions.

Demande

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances/e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f/decisions

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/beta/$metadata#identityGovernance/accessReviews/unified/definitions('29f2d16e-9ca6-4052-bbfe-802c48944448')/instances('e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f')/decisions",
    "value": [
        {
            "id": "9f8c2b1a-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
            "decision": "NotReviewed",
            "principal": {
                "id": "a4c6f1e2-6f2d-4b8a-9c3e-2f1a0b5d7e9c",
                "displayName": "Alex Wilber"
            },
            "resource": {
                "id": "b74444cb-038a-4802-8fc9-b9d1ed0cf11f",
                "displayName": "Marketing"
            }
        }
    ]
}

Exemple 4 : Arrêter une instance de révision d’accès unifiée

L’exemple suivant arrête une instance de révision centrée sur l’utilisateur en cours. Pour obtenir des exemples de code dans les SDK Microsoft Graph, consultez accessReviewInstance : stop.

Demande

POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances/e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f/stop

Réponse

HTTP/1.1 204 No Content

Exemple 5 : appliquer les décisions d’une instance de révision d’accès unifiée

L’exemple suivant s’applique aux décisions enregistrées d’une instance de révision centrée sur l’utilisateur terminée. Pour obtenir des exemples de code dans les SDK Microsoft Graph, consultez accessReviewInstance : applyDecisions.

Demande

POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances/e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f/applyDecisions

Réponse

HTTP/1.1 204 No Content

Exemple 6 : Supprimer une définition de révision d’accès unifiée

L’exemple suivant supprime un accessReviewScheduleDefinition centré sur l’utilisateur. Pour obtenir des exemples de code dans les SDK Microsoft Graph, consultez Supprimer accessReviewScheduleDefinition.

Demande

DELETE https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448

Réponse

HTTP/1.1 204 No Content
  • Dernière mise à jour :