Répertorier accessReviewInstanceDecisionItems en attente d’approbation (déconseillé)

  • Article

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 .

Remarque

Cette méthode sera déconseillée et cessera de retourner des données le 19 mai 2023. Il a été remplacé par filterByCurrentUser.

Récupérez les objets accessReviewInstanceDecisionItem pour un accessReviewInstance spécifique en attente d’approbation par l’utilisateur appelant. Une liste de zéro ou plusieurs objets accessReviewInstanceDecisionItem sont retournés, y compris toutes leurs 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.Read.All AccessReview.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.

L’utilisateur connecté voit également uniquement les décisions auxquelles il est affecté réviseur dans le instance accessReviewScheduleDefinition de cette décision.

Requête HTTP

GET /me/pendingAccessReviewInstances/{instance-id}/decisions

Paramètres facultatifs de la requête

Cette méthode prend en charge les $skip paramètres de requête OData et $top pour vous aider à personnaliser la réponse. Pour des informations générales, consultez paramètres de la requête OData.

La taille de page par défaut pour cette API est de 100 objets accessReviewInstanceDecisionItem . 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

Aucun.

Corps de la demande

Ne fournissez pas de corps de demande.

Réponse

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

Exemples

Demande

L’exemple suivant montre une demande de récupération de toutes les décisions sur un instance d’une révision d’accès en attente de l’approbation de l’utilisateur appelant.

GET https://graph.microsoft.com/beta/me/pendingAccessReviewInstances/70a68410-67f3-4d4c-b946-6989e050be19/decisions?$top=100&$skip=0

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": 2,
    "value": [
        {
            "id": "654b34e7-b48f-4772-a2d4-08f1d0dd014c",
            "accessReviewId": "70a68410-67f3-4d4c-b946-6989e050be19",
            "reviewedDateTime": null,
            "decision": "NotReviewed",
            "justification": "",
            "appliedDateTime": null,
            "applyResult": "New",
            "recommendation": "Approve",
            "reviewedBy": {
                "id": "00000000-0000-0000-0000-000000000000",
                "displayName": "",
                "userPrincipalName": ""
            },
            "appliedBy": {
                "id": "00000000-0000-0000-0000-000000000000",
                "displayName": "",
                "userPrincipalName": ""
            },
            "target": {
                "@odata.type": "#microsoft.graph.accessReviewInstanceDecisionItemUserTarget",
                "userId": "7eae986b-d425-48b2-adf2-3c777f6256f3",
                "userDisplayName": "Adele Vance",
                "userPrincipalName": "AdeleV@contoso.com"
            }
        },
        {
            "id": "0311dba4-c60c-412e-ac77-14e1da23daf1",
            "accessReviewId": "70a68410-67f3-4d4c-b946-6989e050be19",
            "reviewedDateTime": null,
            "decision": "NotReviewed",
            "justification": "",
            "appliedDateTime": null,
            "applyResult": "New",
            "recommendation": "Approve",
            "reviewedBy": {
                "id": "00000000-0000-0000-0000-000000000000",
                "displayName": "",
                "userPrincipalName": ""
            },
            "appliedBy": {
                "id": "00000000-0000-0000-0000-000000000000",
                "displayName": "",
                "userPrincipalName": ""
            },
            "target": {
                "@odata.type": "#microsoft.graph.accessReviewInstanceDecisionItemUserTarget",
                "userId": "957f1027-c0ee-460d-9269-b8828e59e0fe",
                "userDisplayName": "MOD Administrator",
                "userPrincipalName": "admin@contoso.com"
            }
        }
    ]
}

Contenu connexe