temporaryAccessPassAuthenticationMethod 资源类型

命名空间:microsoft.graph

重要

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

表示已注册给用户的临时访问通行证。 临时访问通行证是一种限时密码,可作为强凭据并允许载入无密码凭据。 可为 temporaryAccessPassAuthenticationMethod 配置的可用性和设置取决于 临时访问通行证方法策略。

这是继承自 authenticationMethod 资源类型的派生类型。

方法

方法 返回类型 Description
List temporaryAccessPassAuthenticationMethod 集合 检索用户的 临时 AccessPassAuthenticationMethod 对象及其属性的列表。 用户只能使用一种 Temporary Access Pass 身份验证方法。
创建 temporaryAccessPassAuthenticationMethod 创建用户的 临时 AccessPassAuthenticationMethod 对象。
Get temporaryAccessPassAuthenticationMethod 检索用户的 temporaryAccessPassAuthenticationMethod 对象的属性。
删除 无 删除用户的 临时 AccessPassAuthenticationMethod 对象。

属性

属性 类型 说明
createdDateTime DateTimeOffset 创建临时访问通行证的日期和时间。
id String 注册到此用户的临时访问通行证的标识符。 继承自 entity。
isUsableOnce 布尔值 确定通行证是否仅限为一次性使用。 如果 ,该 true通行证只能使用一次;如果 ,则 false在临时访问通行证生命周期内可以多次使用该通行证。
isUsable 布尔值 身份验证方法的状态,指示用户当前是否可以使用该方法。
lastUsedDateTime DateTimeOffset 用户上次使用身份验证方法的日期和时间。 只读。 可选。 如果身份验证方法未填充此可选值,则表示 null 此可选值。 时间戳类型使用 ISO 8601 格式表示日期和时间信息,并且始终采用 UTC 格式。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 继承自 authenticationMethod。
lifetimeInMinutes Int32 从 startDateTime 开始的临时访问通行证的生存期(以分钟为单位)。 必须介于 10 和 43200(含)之间 (相当于 30 天) 。
methodUsabilityReason String 有关可用性状态 (isUsable) 的详细信息。 原因可能包括: EnabledByPolicy、 DisabledByPolicy、 Expired、 NotYetValid、 OneTimeUsed。
startDateTime DateTimeOffset 临时访问通行证可供使用以及强制执行 isUsabletrue 的日期和时间。
temporaryAccessPass String 用于身份验证的临时访问密码。 仅在创建新的 temporaryAccessPassAuthenticationMethod 对象时返回;在后续读取操作中隐藏,并且与 GET 一样 null 返回。

关系

无。

以下 JSON 表示形式显示资源类型。

{
  "@odata.type": "#microsoft.graph.temporaryAccessPassAuthenticationMethod",
  "id": "String (identifier)",
  "temporaryAccessPass": "String",
  "createdDateTime": "String (timestamp)",
  "lastUsedDateTime": "String (timestamp)",
  "startDateTime": "String (timestamp)",
  "lifetimeInMinutes": "Integer",
  "isUsableOnce": "Boolean",
  "isUsable": "Boolean",
  "methodUsabilityReason": "String"
}