customSecurityAttributeDefinition 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 the schema of a custom security attribute (key-value pair). For example, the custom security attribute name, description, data type, and allowed values.

You can define up to 500 active objects in a tenant. The customSecurityAttributeDefinition object can't be renamed or deleted, but it can be deactivated by using the Update customSecurityAttributeDefinition operation. Must be part of an attributeSet.

Inherits from entity.

Methods

Method Return type Description
List customSecurityAttributeDefinition collection Get a list of the customSecurityAttributeDefinition objects and their properties.
Get customSecurityAttributeDefinition Read the properties and relationships of a customSecurityAttributeDefinition object.
Create customSecurityAttributeDefinition Create a new customSecurityAttributeDefinition object.
Update customSecurityAttributeDefinition Update the properties of a customSecurityAttributeDefinition object.

Properties

Property Type Description
attributeSet String Name of the attribute set. Case insensitive.
description String Description of the custom security attribute. Can be up to 128 characters long and include Unicode characters. Can be changed later.
id String Identifier of the custom security attribute, which is a combination of the attribute set name and the custom security attribute name separated by an underscore (attributeSet_name). The id property is auto generated and cannot be set. Case insensitive. Inherited from entity.
isCollection Boolean Indicates whether multiple values can be assigned to the custom security attribute. Cannot be changed later. If type is set to Boolean, isCollection cannot be set to true.
isSearchable Boolean Indicates whether custom security attribute values are indexed for searching on objects that are assigned attribute values. Cannot be changed later.
name String Name of the custom security attribute. Must be unique within an attribute set. Can be up to 32 characters long and include Unicode characters. Cannot contain spaces or special characters. Cannot be changed later. Case insensitive.
status String Specifies whether the custom security attribute is active or deactivated. Acceptable values are: Available and Deprecated. Can be changed later.
type String Data type for the custom security attribute values. Supported types are: Boolean, Integer, and String. Cannot be changed later.
usePreDefinedValuesOnly Boolean Indicates whether only predefined values can be assigned to the custom security attribute. If set to false, free-form values are allowed. Can later be changed from true to false, but cannot be changed from false to true. If type is set to Boolean, usePreDefinedValuesOnly cannot be set to true.

Relationships

Relationship Type Description
allowedValues allowedValue collection Values that are predefined for this custom security attribute. This navigation property is not returned by default and must be specified in an $expand query. For example, /directory/customSecurityAttributeDefinitions?$expand=allowedValues.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.customSecurityAttributeDefinition",
  "attributeSet": "String",
  "description": "String",
  "id": "String (identifier)",
  "isCollection": "Boolean",
  "isSearchable": "Boolean",
  "name": "String",
  "status": "String",
  "type": "String",
  "usePreDefinedValuesOnly": "Boolean"
}