Répertorier accessReviews (déconseillé)

Article
04/04/2024

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 .

Attention

Cette version de l’API de révision d’accès est déconseillée et cessera de retourner des données le 19 mai 2023. Utilisez l’API révisions d’accès.

Récupérez les objets accessReview pour un businessFlowTemplate particulier. Une liste de zéro ou plusieurs objets accessReview sont retournés, pour chaque révision d’accès ponctuelle et périodique créée avec ce modèle de flux d’entreprise. Les ID de modèle de flux d’entreprise respectent la casse.

Remarque

Si l’une des révisions d’accès qui correspondent au filtre est une révision d’accès périodique, un objet accessReview est retourné pour représenter chaque série périodique dans son ensemble, en plus des instance actuelles, passées et suivantes à venir. Par exemple, s’il existe une révision d’accès périodique mensuelle des membres invités du groupe A, une révision d’accès périodique trimestrielle des membres invités du groupe B et une révision d’accès unique des membres invités du groupe C, chacune de ces périodicités vient de commencer, et l’appelant interroge les révisions d’accès avec un modèle de flux d’entreprise de révisions des membres invités des groupes, trois objets représentant les trois séries sont retournés, ainsi que trois objets pour les instances de révision d’accès actuelles et potentiellement trois objets pour les instances à venir suivantes. Pour récupérer les instances d’une révision d’accès périodique, ou la révision d’accès instance planifiée pour un mois ou un trimestre particulier, l’appelant peut par la suite parcourir la relation instance de l’objet accessReview périodique. La relation instance est liée aux objets accessReview pour une instance actuelle ou passée de la révision d’accès périodique.

Si de nombreuses révisions d’accès correspondent au filtre, pour améliorer l’efficacité et éviter les délais d’expiration, récupérez le jeu de résultats dans les pages, en incluant à la fois le $top paramètre de requête avec une taille de page, par exemple 100, et le paramètre de $skip=0 requête dans la requête. Ces paramètres peuvent être inclus même si vous ne prévoyez pas que la requête s’étend sur plusieurs pages. Lorsqu’un jeu de résultats s’étend sur plusieurs pages, Microsoft Graph renvoie cette page avec une @odata.nextLink propriété dans la réponse qui contient une URL vers la page de résultats suivante. Si cette propriété est présente, continuez à effectuer des requêtes avec l’URL @odata.nextLink dans chaque réponse, jusqu’à ce que tous les résultats soient retournés, comme décrit dans pagination des données Microsoft Graph dans votre application.

Les objets accessReview retournés par cette API n’incluent pas les propriétés de structure imbriquées telles que les paramètres ou les relations. Pour récupérer des paramètres ou des relations de révision d’accès, utilisez l’API get accessReview .

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.Membership, AccessReview.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.	Non prise en charge.
Application	AccessReview.Read.All	AccessReview.ReadWrite.Membership

L’utilisateur connecté doit également être dans un rôle d’annuaire qui lui permet de lire une révision d’accès.

Requête HTTP

GET /accessReviews?$filter=businessFlowTemplateId eq {businessFlowTemplate-id}&$top={pagesize}&$skip=0

En-têtes de demande

Nom	Type	Description
Autorisation	string	Porteur {token}. Obligatoire.

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 accessReview dans le corps de la réponse.

Exemples

Demande

L’exemple suivant montre une demande de récupération de toutes les révisions d’accès ponctuelles et périodiques pour un modèle de flux d’entreprise « 6e4f3d20-c5c3-407f-9695-8460952bcc68 ».

GET https://graph.microsoft.com/beta/accessReviews?$filter=businessFlowTemplateId+eq+'6e4f3d20-c5c3-407f-9695-8460952bcc68'&$top=100&$skip=0


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.AccessReviews.GetAsync((requestConfiguration) =>
{
	requestConfiguration.QueryParameters.Filter = "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'";
	requestConfiguration.QueryParameters.Top = 100;
	requestConfiguration.QueryParameters.Skip = 0;
});

Importante

Microsoft Graph SDK utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, consultez Utiliser les kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).



mgc-beta access-reviews list --top "100" --skip "0" --filter "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'"

Importante



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphaccessreviews "github.com/microsoftgraph/msgraph-beta-sdk-go/accessreviews"
	  //other-imports
)


requestFilter := "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'"
requestTop := int32(100)
requestSkip := int32(0)

requestParameters := &graphaccessreviews.AccessReviewsRequestBuilderGetQueryParameters{
	Filter: &requestFilter,
	Top: &requestTop,
	Skip: &requestSkip,
}
configuration := &graphaccessreviews.AccessReviewsRequestBuilderGetRequestConfiguration{
	QueryParameters: requestParameters,
}

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
accessReviews, err := graphClient.AccessReviews().Get(context.Background(), configuration)

Importante


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

AccessReviewCollectionResponse result = graphClient.accessReviews().get(requestConfiguration -> {
	requestConfiguration.queryParameters.filter = "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'";
	requestConfiguration.queryParameters.top = 100;
	requestConfiguration.queryParameters.skip = 0;
});

Importante


const options = {
	authProvider,
};

const client = Client.init(options);

let accessReviews = await client.api('/accessReviews')
	.version('beta')
	.filter('businessFlowTemplateId eq \'6e4f3d20-c5c3-407f-9695-8460952bcc68\'')
	.skip(0)
	.top(100)
	.get();

Importante


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\AccessReviews\AccessReviewsRequestBuilderGetRequestConfiguration;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestConfiguration = new AccessReviewsRequestBuilderGetRequestConfiguration();
$queryParameters = AccessReviewsRequestBuilderGetRequestConfiguration::createQueryParameters();
$queryParameters->filter = "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'";
$queryParameters->top = 100;
$queryParameters->skip = 0;
$requestConfiguration->queryParameters = $queryParameters;


$result = $graphServiceClient->accessReviews()->get($requestConfiguration)->wait();

Importante


Import-Module Microsoft.Graph.Beta.Identity.Governance

Get-MgBetaAccessReview -Filter "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'" -Top 100 -Skip 0

Importante


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.access_reviews.access_reviews_request_builder import AccessReviewsRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
query_params = AccessReviewsRequestBuilder.AccessReviewsRequestBuilderGetQueryParameters(
		filter = "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'",
		top = 100,
		skip = 0,
)

request_configuration = RequestConfiguration(
query_parameters = query_params,
)

result = await graph_client.access_reviews.get(request_configuration = request_configuration)

Importante

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": "2b83cc42-09db-46f6-8c6e-16fec466a82d",
         "displayName": "review",
         "startDateTime": "2017-11-14T01:14:54.89Z",
         "endDateTime": "2017-12-14T01:14:54.89Z",
         "status": "InProgress",
         "businessFlowTemplateId": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
         "reviewerType": "self",
         "description": "",
         "reviewedEntity":{"id":"3b4f7e74-eb82-4120-9ff5-ba429c1ea6df","displayName":"Salesforce"}
       }
    ]
}

Obtenir accessReview

Partager via

Répertorier accessReviews (déconseillé)

Autorisations

Requête HTTP

En-têtes de demande

Corps de la demande

Réponse

Exemples

Demande

Réponse

Commentaires

Ressources supplémentaires

Partager via

Répertorier accessReviews (déconseillé)

Autorisations

Requête HTTP

En-têtes de demande

Corps de la demande

Réponse

Exemples

Demande

Réponse

Contenu connexe

Commentaires

Ressources supplémentaires