Edit

conditionalAccessSettings resource type (Conditional Access)

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 tenant-wide Conditional Access settings, including user-action exclusions for policies that target all resources.

Inherits from entity.

Access this singleton through /identity/conditionalAccess/settings. The singleton exists automatically; creating or listing settings isn't supported.

Methods

Method Return type Description
Get conditionalAccessSettings (Conditional Access) conditionalAccessSettings Get the tenant's Conditional Access settings.
Update conditionalAccessSettings (Conditional Access) conditionalAccessSettings Update the tenant's Conditional Access settings.
Delete conditionalAccessSettings None Reset Conditional Access settings to their defaults.

Properties

Property Type Description
exclusions conditionalAccessExclusions The tenant-wide exclusions configuration.
id String The unique identifier of the settings resource. Read-only. Inherited from entity.
modifiedDateTime DateTimeOffset The date and time the settings were last modified, in ISO 8601 format and UTC. Nullable. Read-only.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.conditionalAccessSettings",
  "id": "String (identifier)",
  "modifiedDateTime": "String (timestamp)",
  "exclusions": {
    "@odata.type": "microsoft.graph.conditionalAccessExclusions"
  }
}