列出 credentialUserRegistrationDetails

命名空间:microsoft.graph

重要

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

获取给定租户 的 credentialUserRegistrationDetails 对象列表。

权限

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

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) Reports.Read.All
委派(个人 Microsoft 帐户) 不支持。
应用 Reports.Read.All

HTTP 请求

GET /reports/credentialUserRegistrationDetails

可选的查询参数

此函数支持可选的 OData 查询参数 $filter。 你可以将 $filter 凭据 UserRegistrationDetails 资源的以下一个或多个属性应用。

属性 说明和示例
userDisplayName 按用户名筛选。 例如:/reports/credentialUserRegistrationDetails?$filter=userDisplayName eq 'Contoso'。 支持的筛选器运算符: eqstartswith() 。 支持不区分大小写。
userPrincipalName 按用户主体名称进行筛选。 例如:/reports/credentialUserRegistrationDetails?$filter=userPrincipalName eq 'Contoso'。 支持的筛选器运算符: eqstartswith() 。 支持不区分大小写。
authMethods 按注册期间使用的身份验证方法进行筛选。 例如:/reports/credentialUserRegistrationDetails?$filter=authMethods/any(t:t eq microsoft.graph.registrationAuthMethod'email')。 支持的筛选器运算符 eq :。
isRegistered 筛选已注册 SSPR 服务中的自助服务密码重置 (用户) 。 例如:/reports/credentialUserRegistrationDetails?$filter=isRegistered eq true。 支持的筛选器运算符 eq :。
isEnabled 筛选已启用 SSPR 的用户。 例如:/reports/credentialUserRegistrationDetails?$filter=isEnabled eq true。 支持的筛选运算符 eq :。
isCapable 筛选准备在 MFA 中执行密码重置或多重 (的用户) 。 例如:/reports/credentialUserRegistrationDetails?$filter=isCapable eq true。 支持的筛选器运算符: eq
isMfaRegistered 筛选注册了 MFA 的用户。 例如:/reports/credentialUserRegistrationDetails?$filter=isMfaRegistered eq true。 支持的筛选器运算符 eq :。

请求标头

名称 说明
Authorization 持有者 {token}
Content-Type application/json

请求正文

请勿提供此方法的请求正文。

响应

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

示例

以下示例演示如何调用此 API。

请求

下面展示了示例请求。

GET https://graph.microsoft.com/beta/reports/credentialUserRegistrationDetails

响应

下面展示了示例响应。

注意: 为了提高可读性,可能缩短了此处显示的响应对象。 所有属性都从实际调用中返回。

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

{
  "@odata.context":"https://graph.microsoft.com/beta/reports/$metadata#Collection(microsoft.graph.credentialUserRegistrationDetails)",
  "value":[
    {
      "id" : "id-value",
      "userPrincipalName":"userPrincipalName",
      "userDisplayName": "userDisplayName-value",
      "authMethods": ["email", "mobileSMS"],
      "isRegistered" : false,
      "isEnabled" : true,
      "isCapable" : false,
      "isMfaRegistered" : true
    }
  ]
}