Microsoft Graph · Schema

microsoft.graph.roleAssignment

Azure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Tasks
View JSON Schema on GitHub

JSON Schema

microsoft-graph-microsoftgraphroleassignment-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/microsoft.graph.roleAssignment",
  "title": "microsoft.graph.roleAssignment",
  "allOf": [
    {
      "$ref": "#/components/schemas/microsoft.graph.entity"
    },
    {
      "title": "roleAssignment",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "description": {
          "type": "string",
          "description": "Indicates the description of the role assignment. For example: 'All administrators, employees and scope tags associated with the Houston office.' Max length is 1024 characters.",
          "nullable": true
        },
        "displayName": {
          "type": "string",
          "description": "Indicates the display name of the role assignment. For example: 'Houston administrators and users'. Max length is 128 characters.",
          "nullable": true
        },
        "resourceScopes": {
          "type": "array",
          "items": {
            "type": "string",
            "nullable": true
          },
          "description": "Indicates the list of resource scope security group Entra IDs. For example: {dec942f4-6777-4998-96b4-522e383b08e2}."
        },
        "roleDefinition": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.roleDefinition"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Indicates the role definition for this role assignment.",
          "x-ms-navigationProperty": true
        },
        "@odata.type": {
          "type": "string"
        }
      },
      "description": "The Role Assignment resource. Role assignments tie together a role definition with members and scopes. There can be one or more role assignments per role. This applies to custom and built-in roles.",
      "discriminator": {
        "propertyName": "@odata.type",
        "mapping": {
          "#microsoft.graph.deviceAndAppManagementRoleAssignment": "#/components/schemas/microsoft.graph.deviceAndAppManagementRoleAssignment"
        }
      }
    }
  ]
}