Partage via

Historique des listesDefinitions

  • Article

Espace de noms: microsoft.graph

Récupérez les objets accessReviewHistoryDefinition créés au cours des 30 derniers jours, y compris toutes les propriétés imbriquées.

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

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

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) AccessReview.ReadWrite.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application AccessReview.ReadWrite.All Non disponible.

Si l’utilisateur connecté n’a pas au moins le membre du rôle d’annuaire Lecteur global, seules les définitions créées par l’utilisateur connecté sont retournées.

Requête HTTP

GET /identityGovernance/accessReviews/historyDefinitions

Paramètres facultatifs de la requête

Cette méthode prend en charge les $topparamètres de requête , $filter, $expandet $skip OData pour vous aider à personnaliser la réponse. Pour des informations générales, consultez paramètres de la requête OData. L’inclusion ?$expand=instances retourne les objets accessReviewHistoryDefinitions ainsi que leurs instances associées.

La taille de page par défaut pour cette API est de 100 objets accessReviewHistoryDefinitions . Pour améliorer l’efficacité et éviter les délais d’expiration dus à des jeux de résultats volumineux, appliquez la pagination à l’aide des paramètres de $skip requête et $top . Pour plus d’informations, voir Pagination des données Microsoft Graph dans votre application.

En-têtes de demande

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

Corps de la demande

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

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et une collection d’objets accessReviewHistoryDefinition dans le corps de la réponse.

Exemples

Demande

GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/historyDefinitions

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.count": 1,
    "value": [
        {
            "@odata.type": "#microsoft.graph.accessReviewHistoryDefinition",
            "id": "67e3de15-d263-45a9-8f4f-71271b495db7",
            "displayName": "Last year's ELM assignment reviews - one time",
            "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",
            "reviewHistoryPeriodEndDateTime": "2021-04-05T00:00:00Z",
            "decisions": [
                "approve",
                "deny",
                "dontKnow",
                "notReviewed",
                "notNotified"
            ],
            "status": "done",
            "createdDateTime": "2021-04-14T00:22:48.9392594Z",
            "createdBy": {
                "id": "957f1027-c0ee-460d-9269-b8444459e0fe",
                "displayName": "MOD Administrator",
                "userPrincipalName": "admin@contoso.com"
            },
            "scopes": [
                {
                    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
                    "queryType": "MicrosoftGraph",
                    "query": "/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, 'accessPackageAssignments')",
                    "queryRoot": null
                }
            ]
        }
    ]
}