temporaryAccessPassAuthenticationMethod resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a Temporary Access Pass registered to a user. A Temporary Access Pass is a time-limited passcode that serves as a strong credential and allows onboarding of passwordless credentials. The availability and settings that can be configured for the temporaryAccessPassAuthenticationMethod depends on the Temporary Access Pass methods policy.

This is a derived type that inherits from the authenticationMethod resource type.

Methods

Method	Return type	Description
List	temporaryAccessPassAuthenticationMethod collection	Retrieve a list of a user's temporaryAccessPassAuthenticationMethod objects and their properties. Users can only have one Temporary Access Pass authentication method.
Create	temporaryAccessPassAuthenticationMethod	Create a user's temporaryAccessPassAuthenticationMethod object.
Get	temporaryAccessPassAuthenticationMethod	Retrieve the properties of the user's temporaryAccessPassAuthenticationMethod object.
Delete	None	Delete a user's temporaryAccessPassAuthenticationMethod object.

Properties

Property	Type	Description
createdDateTime	DateTimeOffset	The date and time when the Temporary Access Pass was created.
id	String	The identifier of the Temporary Access Pass registered to this user. Inherited from entity.
isUsableOnce	Boolean	Determines whether the pass is limited to a one-time use. If true, the pass can be used once; if false, the pass can be used multiple times within the Temporary Access Pass lifetime.
isUsable	Boolean	The state of the authentication method that indicates whether it's currently usable by the user.
lifetimeInMinutes	Int32	The lifetime of the Temporary Access Pass in minutes starting at startDateTime. Must be between 10 and 43200 inclusive (equivalent to 30 days).
methodUsabilityReason	String	Details about the usability state (isUsable). Reasons can include: EnabledByPolicy, DisabledByPolicy, Expired, NotYetValid, OneTimeUsed.
startDateTime	DateTimeOffset	The date and time when the Temporary Access Pass becomes available to use and when isUsable is true is enforced.
temporaryAccessPass	String	The Temporary Access Pass used to authenticate. Returned only on creation of a new temporaryAccessPassAuthenticationMethod object; Hidden in subsequent read operations and returned as null with GET.

Relationships

None.

The following JSON representation shows the resource type. The following is a JSON representation of the resource.

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