命名空间: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"
}