列出 accessreviews (已弃用)
本文内容
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
警告
此版本的访问评审 API 已弃用,将于 2023 年 5 月 19 日停止返回数据。 请使用 访问评审 API 。
检索特定 businessFlowTemplate 的 accessReview 对象。 对于使用该业务流模板创建的每个一次性和定期访问评审,将返回零个或多个 accessReview 对象的列表。 请注意,业务流模板 ID 区分大小写。
注意
如果与筛选器匹配的任何访问评审是定期访问评审,则除了任何当前、过去和下一个即将发生的实例外,还将返回一个 accessReview 对象,以将每个定期序列表示为一个整体。 例如,如果对组 A 的来宾成员进行每月定期访问评审,对组 B 的来宾成员进行季度定期访问评审,以及对组 C 的来宾成员进行一次性访问评审,则每个定期访问刚刚启动,并且调用方使用组来宾成员评审的业务流模板来查询访问评审, 将返回三个对象,表示三个系列,以及三个对象用于当前访问评审实例,可能为下一个即将发生的实例返回三个对象。 若要检索定期访问评审的实例或计划在特定月份或季度的访问评审实例,调用方随后可以导航定期 accessReview 对象的实例 关系。 实例 关系链接到定期访问评审的当前或过去实例的 accessReview 对象。
如果许多访问评审与筛选器匹配,为了提高效率并避免超时,请在页面中检索结果集,方法是将查询参数(例如 100)和$skip=0
查询参数包含在$top
请求中。 即使你预计请求不会跨越多个页面,也可以包含这些参数。 当结果集跨越多个页面时,Microsoft Graph 返回该页面,该页面在 @odata.nextLink
响应中包含指向下一页结果的 URL 的属性。 如果该属性存在,请继续使用每次响应中的 @odata.nextLink
URL 来创建额外请求,直至返回所有结果,如在应用中对 Microsoft Graph 数据进行分页 一文中所述。
此 API 返回的 accessReview 对象将不包括嵌套结构属性,例如 设置 或关系。 若要检索访问评审设置或关系,请使用 get accessReview API。
此 API 可用于以下国家级云部署 。
全局服务
美国政府 L4
美国政府 L5 (DOD)
由世纪互联运营的中国
✅
✅
✅
✅
权限
为此 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
// 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;
});
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta access-reviews list --top "100" --skip "0" --filter "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'"
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphaccessreviews "github.com/microsoftgraph/msgraph-beta-sdk-go/accessreviews"
//other-imports
)
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
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,
}
accessReviews, err := graphClient.AccessReviews().Get(context.Background(), configuration)
// 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;
});
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();
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\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();
Import-Module Microsoft.Graph.Beta.Identity.Governance
Get-MgBetaAccessReview -Filter "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'" -Top 100 -Skip 0
from msgraph import GraphServiceClient
from msgraph.generated.accessReviews.access_reviews_request_builder import AccessReviewsRequestBuilder
graph_client = GraphServiceClient(credentials, scopes)
query_params = AccessReviewsRequestBuilder.AccessReviewsRequestBuilderGetQueryParameters(
filter = "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'",
top = 100,
skip = 0,
)
request_configuration = AccessReviewsRequestBuilder.AccessReviewsRequestBuilderGetRequestConfiguration(
query_parameters = query_params,
)
result = await graph_client.access_reviews.get(request_configuration = request_configuration)
响应
注意: 为了提高可读性,可能缩短了此处显示的响应对象。
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"}
}
]
}
相关内容