activityBasedTimeoutPolicy resource type

Articolo
05/24/2024

Namespace: microsoft.graph

Represents a policy that can control the idle timeout for web sessions for applications that support activity-based timeout functionality. Applications enforce automatic sign out after a period of inactivity. This type of policy can only be applied at the organization level (by setting the isOrganizationDefault property to true).

Inherits from stsPolicy.

Methods

Method	Return Type	Description
List	activityBasedTimeoutPolicy	Read properties and relationships of activityBasedTimeoutPolicy objects.
Create	activityBasedTimeoutPolicy	Create an activityBasedTimeoutPolicy object.
Get	activityBasedTimeoutPolicy	Read properties and relationships of an activityBasedTimeoutPolicy object.
Update	None	Update an activityBasedTimeoutPolicy object.
Delete	None	Delete an activityBasedTimeoutPolicy object.

Properties

Property	Type	Description
definition	String collection	A string collection containing a JSON string that defines the rules and settings for this policy. See below for more details about the JSON schema for this property. Required.
description	String	Description for this policy.
displayName	String	Display name for this policy. Required.
id	String	Unique identifier for this policy. Read-only.
isOrganizationDefault	Boolean	If set to true, activates this policy. There can be many policies for the same policy type, but only one can be activated as the organization default. Optional, default value is false.

Properties of an activity-based timeout policy definition

The properties below form the JSON object that represents an activity-based timeout policy. This JSON object must be converted to a string with quotations escaped to be inserted into the definition property. An example is shown below in JSON format:

{
  "definition":["{\"ActivityBasedTimeoutPolicy\":{\"Version\":1,\"ApplicationPolicies\":[{\"ApplicationId\":\"default\",\"WebSessionIdleTimeout\":\"01:00:00\"},{\"ApplicationId\":\"c44b4083-3bb0-49c1-b47d-974e53cbdf3c\",\"WebSessionIdleTimeout\":\"00:15:00\"}]}}"]
}

Note: All time durations in these properties are specified in the format "dd.hh:mm:ss".

Note: Max values for properties denoted in "days" are 1 second short of the denoted number of days. For example, the max value of 1 days is specified as "23:59:59".

Property	Type	Description
ApplicationPolicies	JSON object	Collection of application policy. An application policy, is a combination of an ApplicationId and a WebSessionIdleTimeout: ApplicationId: Allowed values: default: applies the policy to all applications that support activity-based timeout functionality but don't have application-specific override c44b4083-3bb0-49c1-b47d-974e53cbdf3c: applies the policy to the Azure portal WebSessionIdleTimeout: The period of user inactivity after which the user's web session is considered expired. The minimum value is 5 minutes; the maximum value is one day.
Version	Integer	Policy version. Set value of 1. Required.

Relationships

None

JSON representation

The following JSON representation shows the resource type.

{
  "definition": ["String"],
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "isOrganizationDefault": true
}

Condividi tramite