命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
重要
用户凭据使用情况详细信息 API 已弃用，将于 2025 年 8 月 1 日停止返回数据。 请改用新的 用户事件摘要 API。
表示给定租户的自助密码重置用法。 详细信息包括用户信息、重置状态和失败原因。 有关此功能的许可证要求的详细信息，请参阅 身份验证方法活动：权限和许可证。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | userCredentialUsageDetails | 读取 userCredentialUsageDetails 对象的属性和关系。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| authMethod | usageAuthMethod | 表示用户使用的身份验证方法。 可能的值为：email、、mobileSMS、、mobileCall、microsoftAuthenticatorPushalternateMobileCallappCodefidoappNotificationsecurityQuestionofficePhoneappPasswordunknownFutureValuemicrosoftAuthenticatorPasswordlesswindowsHelloForBusinesstemporaryAccessPasshardwareOneTimePasscodemacOsSecureEnclaveKeypassKeyDeviceBoundpassKeyDeviceBoundWindowsHellomobilePhonesmssoftwareOneTimePasscodeexternalAuthMethodpassKeyDeviceBoundAuthenticatoralternateMobilePhone、fido2SecurityKey、oneTimePasscode、 。 passKeySynced
Prefer: include-unknown-enum-members使用请求标头从此可演变枚举中获取以下值： externalAuthMethod 、、 hardwareOneTimePasscode 、、 microsoftAuthenticatorPasswordlesspassKeyDeviceBoundAuthenticatortemporaryAccessPasswindowsHelloForBusinessmacOsSecureEnclaveKeypassKeyDeviceBound 、 passKeyDeviceBoundWindowsHello 、 smsmobilePhonesoftwareOneTimePasscodemicrosoftAuthenticatorPushalternateMobilePhone 、 fido2SecurityKey 、 oneTimePasscode 、 。 passKeySynced |
| eventDateTime | DateTimeOffset | 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| failureReason | String | 提供相应重置或注册工作流的失败原因。 |
| 特征 | featureType | 可取值为：registration、reset、unknownFutureValue。 |
| id | String | 只读。 活动的唯一标识符。 只读。 |
| isSuccess | 布尔值 | 指示工作流的成功或失败。 |
| userDisplayName | String | 执行重置或注册工作流的用户的用户名。 |
| userPrincipalName | String | 执行重置或注册工作流的用户的用户主体名称。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"id" : "String",
"feature":"string",
"userPrincipalName":"String",
"userDisplayName": "String",
"isSuccess" : true,
"authMethod": "string",
"failureReason": "String",
"eventDateTime" : "DateTimeOffset"
}