Edit

governancePolicyTemplate resource type

Namespace: microsoft.graph.tenantGovernanceServices

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 policy template that defines the configuration for governance relationships, including delegated administration role assignments and multi-tenant applications to provision. Policy templates are used when creating governanceRequest objects and are stored as snapshots in established governanceRelationship objects.

The system provides a default policy template with the ID default. This template serves as a reusable configuration that is applied when governance relationships are automatically created for add-on tenants. The default template cannot be deleted.

Inherits from microsoft.graph.entity.

Methods

Method Return type Description
List microsoft.graph.tenantGovernanceServices.governancePolicyTemplate collection Get a list of the governancePolicyTemplate objects and their properties.
Create microsoft.graph.tenantGovernanceServices.governancePolicyTemplate Create a new governance policy template.
Get microsoft.graph.tenantGovernanceServices.governancePolicyTemplate Read the properties of a governancePolicyTemplate object, including the system-provided default template.
Update microsoft.graph.tenantGovernanceServices.governancePolicyTemplate Update the properties of a governance policy template, including the system-provided default template.
Delete None Delete a governance policy template.

Properties

Property Type Description
createdDateTime DateTimeOffset The date and time when the template was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC.

Supports $filter (lt, le, gt, ge, eq, ne) and $orderBy.
delegatedAdministrationRoleAssignments microsoft.graph.tenantGovernanceServices.delegatedAdministrationRoleAssignment collection A collection of delegated administration role assignments to be applied in the governed tenant when the governance relationship is established.
description String A description of the policy template.

Supports $filter (eq, ne) and $orderBy.
displayName String The display name of the policy template.

Supports $filter (eq, ne) and $orderBy.
governedTenantCanTerminate Boolean Not implemented.
id String The unique identifier for the policy template. Is default for the default template. Inherited from entity.

Supports $filter (eq, ne) and $orderBy.
lastModifiedDateTime DateTimeOffset The date and time when the template was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC.

Supports $filter (lt, le, gt, ge, eq, ne) and $orderBy.
multiTenantApplicationsToProvision microsoft.graph.tenantGovernanceServices.multiTenantApplicationsToProvision collection A collection of multi-tenant applications to be provisioned in the governed tenant when the governance relationship is established.
version String The version of the policy template. Version count increased by 1 when updated.

Supports $filter (lt, le, gt, ge, eq, ne) and $orderBy.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.tenantGovernanceServices.governancePolicyTemplate",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "governedTenantCanTerminate": "Boolean",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "version": "String",
  "multiTenantApplicationsToProvision": [
    {
      "@odata.type": "microsoft.graph.tenantGovernanceServices.multiTenantApplicationsToProvision"
    }
  ],
  "delegatedAdministrationRoleAssignments": [
    {
      "@odata.type": "microsoft.graph.tenantGovernanceServices.delegatedAdministrationRoleAssignment"
    }
  ]
}