List permissionGrantPreApprovalPolicies
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
检索租户中的 permissionGrantPreApprovalPolicy 对象列表。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | Policy.Read.PermissionGrant | Policy.ReadWrite.PermissionGrant |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用程序 | Policy.Read.PermissionGrant | Policy.ReadWrite.PermissionGrant |
在具有工作或学校帐户的委托方案中,必须为登录用户分配受支持的 Microsoft Entra 角色 或具有支持的角色权限的自定义角色。 此操作支持以下最低特权角色。
- 全局读取者
- 应用程序管理员
- 云 应用程序管理员
HTTP 请求
GET /policies/permissionGrantPreApprovalPolicies
可选的查询参数
此方法不支持帮助自定义响应的 OData 查询参数。 若要了解一般信息,请参阅 OData 查询参数。
请求标头
名称 | 说明 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
请求正文
请勿提供此方法的请求正文。
响应
如果成功,此方法在响应正文中返回响应 200 OK
代码和 permissionGrantPreApprovalPolicy 对象的集合。
示例
请求
GET https://graph.microsoft.com/beta/policies/permissionGrantPreApprovalPolicies
响应
注意:为了提高可读性,可能缩短了此处显示的响应对象。
在以下示例中:
策略 ID
71ba13dc-5947-4e59-bcc5-0ad5c339a853
具有以下设置:- 资源类型的条件
chat
:- 指示所有聊天,而不考虑敏感度标签都在范围内
- 指定预批准所有 API 的所有应用程序权限
- 资源类型的条件
group
:- 指定范围内的两个敏感度标签
- 指定预批准资源应用的两个应用程序权限
00000003-0000-0000-c000-000000000000
- 资源类型的条件
策略 ID
bd4b701c-a54e-42b8-9f56-e4b4b229be3b
具有以下设置:- 资源类型的条件
group
:- 指示所有组(无论敏感度标签如何)都在范围内
- 指定预批准资源应用的所有应用程序权限
00000003-0000-0000-c000-000000000000
- 资源类型的条件
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/permissionGrantPreApprovalPolicies",
"value": [
{
"id": "71ba13dc-5947-4e59-bcc5-0ad5c339a853",
"deletedDateTime": null,
"conditions": [
{
"scopeType": "chat",
"sensitivityLabels": {
"@odata.type": "#microsoft.graph.allScopeSensitivityLabels",
"labelKind": "all"
},
"permissions": {
"@odata.type": "#microsoft.graph.allPreApprovedPermissions",
"permissionKind": "all",
"permissionType": "application"
}
},
{
"scopeType": "group",
"scopeSensitivityLabels": {
"@odata.type": "microsoft.graph.enumeratedScopeSensitivityLabels",
"labelKind": "enumerated",
"sensitivityLabels": [
"d9c43deb-f3e1-4422-9fd6-ccf22a3206b8",
"c99dade2-aa54-4890-ac1c-a146fa26bd1e"
]
},
"permissions": {
"@odata.type": "#microsoft.graph.enumeratedPreApprovedPermissions",
"permissionKind": "enumerated",
"permissionType": "application",
"resourceApplicationId": "00000003-0000-0000-c000-000000000000",
"permissionIds": [
"134483aa-3dda-4d65-ac91-b8dda1417875",
"9d33613d-f855-483b-bca7-ea63ac9f5485"
]
}
}
]
},
{
"id": "bd4b701c-a54e-42b8-9f56-e4b4b229be3b",
"deletedDateTime": null,
"conditions": [
{
"scopeType": "group",
"sensitivityLabels": {
"@odata.type": "#microsoft.graph.allScopeSensitivityLabels",
"labelKind": "all"
},
"permissions": {
"@odata.type": "#microsoft.graph.allPermissionsOnResourceApp",
"permissionKind": "allPermissionsOnResourceApp",
"permissionType": "application",
"resourceApplicationId": "00000003-0000-0000-c000-000000000000"
}
}
]
}
]
}