categoryTemplate resource type

Namespace: microsoft.graph.security

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.

Specifies a group of similar types of content in a particular department. This resource supports CRUD operations to apply and manage the filePlanAppliedCategory descriptor, and any filePlanSubcategory descriptor for a retentionLabel. These file plan descriptors supplement a retention label to improve the manageability and organization of Microsoft 365 content.

Inherits from microsoft.graph.security.filePlanDescriptorTemplate.

Methods

Method Return type Description
List categories microsoft.graph.security.categoryTemplate collection Get a list of the microsoft.graph.security.categoryTemplate objects and their properties.
Create categories microsoft.graph.security.categoryTemplate Create a new microsoft.graph.security.categoryTemplate object.
Get categories microsoft.graph.security.categoryTemplate Read the properties and relationships of a microsoft.graph.security.categoryTemplate object.
Delete categories None Delete a microsoft.graph.security.categoryTemplate object.
List subcategories microsoft.graph.security.subcategoryTemplate collection Get the subcategoryTemplate resources from the subcategories navigation property.
Create subcategories microsoft.graph.security.subcategoryTemplate Create a new subcategoryTemplate object.

Properties

Property Type Description
createdBy microsoft.graph.identitySet Represents the user who created the category descriptor. Inherited from microsoft.graph.security.filePlanDescriptorTemplate. Read-only.
createdDateTime DateTimeOffset Represents the date and time in which the category descriptor is created. Inherited from microsoft.graph.security.filePlanDescriptorTemplate. Read-only.
displayName String Unique string that defines a category name. Inherited from microsoft.graph.security.filePlanDescriptorTemplate.
id String Unique ID of the category. Inherited from microsoft.graph.entity. Read-only.

Relationships

Relationship Type Description
subcategories microsoft.graph.security.subcategoryTemplate collection Represents all subcategories under a particular category.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.security.categoryTemplate",
  "id": "String (identifier)",
  "displayName": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)"
}