列出 temporaryAccessPassAuthenticationMethods
命名空间:microsoft.graph
重要
Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
检索用户的 临时AccessPassAuthenticationMethod 对象及其属性的列表。 此调用将仅返回一个对象,因为只能对用户设置一个临时访问传递方法。
权限
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限。
对自我执行操作的权限
| 权限类型 | 权限(从最低特权到最高特权) |
|---|---|
| 委派(工作或学校帐户) | UserAuthenticationMethod.Read、UserAuthenticationMethod.ReadWrite |
| 委派(个人 Microsoft 帐户) | 不支持。 |
| 应用程序 | 不支持。 |
对其他用户执行操作的权限
| 权限类型 | 权限(从最低特权到最高特权) |
|---|---|
| 委派(工作或学校帐户) | UserAuthenticationMethod.Read.All、UserAuthenticationMethod.ReadWrite.All |
| 委派(个人 Microsoft 帐户) | 不支持。 |
| 应用 | UserAuthenticationMethod.Read.All、UserAuthenticationMethod.ReadWrite.All |
对于管理员对另一用户执行操作的委派方案,管理员需要以下 角色之一:
- 全局管理员
- 全局读取者
- 特权身份验证管理员
- 身份验证管理员
HTTP 请求
GET /me/authentication/temporaryAccessPassMethods
GET /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods
可选的查询参数
此方法不支持自定义响应的可选查询参数。
请求头
| 名称 | 说明 |
|---|---|
| Authorization | Bearer {token}。必需。 |
请求
请勿提供此方法的请求正文。
响应
如果成功,此方法在响应正文中返回 200 OK 响应代码和 temporaryAccessPassAuthenticationMethod 对象的集合。 此调用仅返回一个对象,因为用户只能设置一个 temporaryAccessPassAuthenticationMethod 。
示例
请求
GET https://graph.microsoft.com/beta/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods
响应
注意: 为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#users('071cc716-8147-4397-a5ba-b2105951cc0b')/authentication/temporaryAccessPassMethods",
"value": [
{
"id": "de517d3d-3b92-4902-a21a-da3e60ee3962",
"temporaryAccessPass": null,
"createdDateTime": "2022-06-03T16:55:19.5684534Z",
"startDateTime": "2022-06-03T16:55:19.3381855Z",
"lifetimeInMinutes": 60,
"isUsableOnce": true,
"isUsable": true,
"methodUsabilityReason": "EnabledByPolicy"
}
]
}
反馈
提交和查看相关反馈