列出已弃用 (accessReviews)

项目
07/18/2022

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

备注

访问评审 API 已弃用，将在 2023 年 5 月 19 日停止返回数据。请使用访问评审。

检索特定 businessFlowTemplate 的 accessReview 对象。对于使用该业务流模板创建的每次一次性和定期访问评审，将返回零个或多个 accessReview 对象的列表。请注意，业务流模板 ID 区分大小写。

备注

如果与筛选器匹配的任何访问评审都是定期访问评审，则除了任何当前、过去和下一个即将推出的实例外，还将返回一个 accessReview 对象来表示每个定期序列作为一个整体。例如，如果每月对组 A 的来宾成员进行定期访问评审、对 B 组的来宾成员进行季度定期访问评审，以及对组 C 的来宾成员进行一次性访问评审，则每个定期访问都刚刚开始，并且调用方使用组的来宾成员评审的业务流模板查询访问评审，将返回三个表示三个序列的对象，以及当前访问评审实例的三个对象，以及下一个即将推出的实例的三个对象。若要检索定期访问评审的实例或计划用于特定月份或季度的访问评审实例，调用方随后可以导航定期 accessReview 对象的实例关系。实例关系链接到 AccessReview 对象，以获取定期访问评审的当前或过去实例。

如果许多访问评审与筛选器匹配，为了提高效率和避免超时，请在页面中检索结果集，方法是同时 $top 包括页面大小为 100 的查询参数和 $skip=0 请求中的查询参数。即使未预料到请求将跨越多个页面，也可以包含这些参数。当结果集跨多个页面时，Microsoft Graph在响应中返回包含@odata.nextLink下一页结果 URL 的属性的页面。如果该属性存在，请继续使用每次响应中的 @odata.nextLink URL 来创建额外请求，直至返回所有结果，如在应用中对 Microsoft Graph 数据进行分页一文中所述。

此 API 返回的 accessReview 对象将不包括嵌套结构属性，例如设置或关系。若要检索访问评审设置或关系，请使用 get accessReview API。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	AccessReview.Read.All、AccessReview.ReadWrite.Membership、AccessReview.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	AccessReview.Read.All、AccessReview.ReadWrite.Membership

已登录的用户还必须具有允许他们读取访问评审的目录角色。

HTTP 请求

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

请求标头

名称	类型	说明
Authorization	string	持有者 {token}。必需。

请求正文

请勿提供请求正文。

响应

如果成功，此方法在响应正文中返回 200 OK 响应代码和 accessReview 对象数组。

示例

请求

以下示例演示了检索业务流模板“6e4f3d20-c5c3-407f-9695-8460952bcc68”的所有一次性和定期访问评审的请求。

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


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var accessReviews = await graphClient.AccessReviews
    .Request()
    .Filter("businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'")
    .Skip(0)
    .Top(100)
    .GetAsync();

重要

Microsoft Graph SDK 默认使用 v1.0 版本的 API，并且不支持 beta 版本中提供的所有类型、属性和 API。有关使用 SDK 访问 beta API 的详细信息，请参阅将 Microsoft Graph SDK 与 beta API 配合使用。

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


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();

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/accessReviews?$filter=businessFlowTemplateId%20eq%20'6e4f3d20-c5c3-407f-9695-8460952bcc68'&$top=100&$skip=0"]]];
[urlRequest setHTTPMethod:@"GET"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        NSError *jsonError = nil;
        MSCollection *collection = [[MSCollection alloc] initWithData:data error:&jsonError];
        MSGraphAccessReview *accessReview = [[MSGraphAccessReview alloc] initWithDictionary:[[collection value] objectAtIndex: 0] error:&nserror];

}];

[meDataTask execute];

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

AccessReviewCollectionPage accessReviews = graphClient.accessReviews()
    .buildRequest()
    .filter("businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'")
    .skip(0)
    .top(100)
    .get();

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestParameters := &msgraphsdk.AccessReviewsRequestBuilderGetQueryParameters{
    Filter: "businessFlowTemplateId%20eq%20'6e4f3d20-c5c3-407f-9695-8460952bcc68'",
    Top: 100,
    Skip: 0,
}
options := &msgraphsdk.AccessReviewsRequestBuilderGetRequestConfiguration{
    QueryParameters: requestParameters,
}
result, err := graphClient.AccessReviews().GetWithRequestConfigurationAndResponseHandler(options, nil)

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


Import-Module Microsoft.Graph.Identity.Governance

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

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

注意： 为了提高可读性，可能缩短了此处显示的响应对象。

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"}
       }
    ]
}

另请参阅

获取 accessReview

列出已弃用 (accessReviews)

权限

HTTP 请求

请求标头

请求正文

响应

示例

请求

响应

另请参阅

反馈