列出 accessReviewInstance

命名空间:microsoft.graph

重要

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

检索特定accessReviewScheduleDefinitionaccessReviewInstance对象。 返回零个或多个 accessReviewInstance 对象的列表,包括其所有嵌套属性。 返回的对象不包括关联的 accessReviewInstanceDecisionItems。 若要检索有关实例的决策,请使用 List accessReviewInstanceDecisionItem

备注

此 API 的默认页面大小为 100 accessReviewInstance 对象。 若要提高效率并避免由于大型结果集而超时,请通过使用 和 查询参数应用 $skip $top 分页。 有关详细信息,请参阅在应用中对 Microsoft Graph 数据进行分页

权限

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

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) AccessReview.Read.All、AccessReview.ReadWrite.All
应用程序 AccessReview.Read.All、AccessReview.ReadWrite.All

登录用户还必须具有允许其读取访问评审的目录角色。 若要查看仅向已登录用户分配审阅者的实例,请参阅列出待处理 的访问评审实例

HTTP 请求

GET /identityGovernance/accessReviews/definitions/{definition-id}/instances

可选的查询参数

此方法支持 $select 、 、 、 和 OData 查询参数 $filter $orderBy $skip $top 来帮助自定义响应。 若要了解一般信息,请参阅 OData 查询参数

请求标头

无。

请求正文

不提供请求正文。

响应

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

示例

请求

以下示例显示检索定义的所有访问评审实例的请求。

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/8564a649-4f67-4e09-88e7-55def6530e88/instances?$top=100&$skip=0

响应

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

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/accessReviews/definitions('8564a649-4f67-4e09-88e7-55def6530e88')/instances",
    "@odata.count": 2,
    "value": [
        {
            "id": "7bc18cf4-3d70-4009-bc8e-a7c5adb30849",
            "startDateTime": "2021-03-09T23:10:28.83Z",
            "endDateTime": "2021-03-09T23:10:28.83Z",
            "status": "Applied",
            "scope": {
                "@odata.type": "#microsoft.graph.accessReviewQueryScope",
                "query": "/v1.0/groups/f661fdd0-f0f7-42c0-8281-e89c6527ac63/members/microsoft.graph.user/?$count=true&$filter=(userType eq 'Guest')",
                "queryType": "MicrosoftGraph",
                "queryRoot": null
            }
        },
        {
            "id": "f1f35945-3f42-4941-9f7b-465e545f6f99",
            "startDateTime": "2021-03-09T23:10:28.83Z",
            "endDateTime": "2021-03-09T23:10:28.83Z",
            "status": "Applied",
            "scope": {
                "@odata.type": "#microsoft.graph.accessReviewQueryScope",
                "query": "/v1.0/groups/f4ac55b3-3b3c-417e-85bd-183bbda3ccf2/members/microsoft.graph.user/?$count=true&$filter=(userType eq 'Guest')",
                "queryType": "MicrosoftGraph",
                "queryRoot": null
            }
        }
    ]
}

另请参阅