role EntityType
Grouping of security privileges. Users are assigned roles that authorize their access to the Microsoft CRM system.
- Entity Set Path
- [organization URI]/api/data/v9.0/roles
- Base Type
- crmbaseentity
- Display Name
- Security Role
- Primary Key
- roleid
- Primary Key Attribute
- name
- Operations Supported
- POST GET PATCH DELETE
Properties
Properties represent fields of data stored in the entity.Some properties are read-only.
| Name | Type | Details | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| canbedeleted | BooleanManagedProperty |
Tells whether the role can be deleted. Display Name: Can Be Deleted |
||||||||||
| componentstate | Edm.Int32 |
For internal use only. Display Name: Component State Read Only
Default Options
|
||||||||||
| createdon | Edm.DateTimeOffset |
Date and time when the role was created. Display Name: Created On Read Only
|
||||||||||
| importsequencenumber | Edm.Int32 |
Unique identifier of the data import or data migration that created this record. Display Name: Import Sequence Number |
||||||||||
| iscustomizable | BooleanManagedProperty |
Information that specifies whether this component can be customized. Display Name: Customizable |
||||||||||
| isinherited | Edm.Int32 |
Role is inherited by users from team membership, if role associated with team. Display Name: Is Inherited
Default Options
|
||||||||||
| ismanaged | Edm.Boolean |
Indicates whether the solution component is part of a managed solution. Display Name: State Read Only
Default Options
|
||||||||||
| modifiedon | Edm.DateTimeOffset |
Date and time when the role was last modified. Display Name: Modified On Read Only
|
||||||||||
| name | Edm.String |
Name of the role. Display Name: Name |
||||||||||
| organizationid | Edm.Guid |
Unique identifier of the organization associated with the role. Display Name: Organization Read Only
|
||||||||||
| overriddencreatedon | Edm.DateTimeOffset |
Date and time that the record was migrated. Display Name: Record Created On |
||||||||||
| overwritetime | Edm.DateTimeOffset |
For internal use only. Display Name: Record Overwrite Time Read Only
|
||||||||||
| roleid | Edm.Guid |
Unique identifier of the role. Display Name: Role |
||||||||||
| roleidunique | Edm.Guid |
For internal use only. Display Name: Unique Id Read Only
|
||||||||||
| solutionid | Edm.Guid |
Unique identifier of the associated solution. Display Name: Solution Read Only
|
||||||||||
| versionnumber | Edm.Int64 |
Version number of the role. Display Name: Version number Read Only
|
Lookup Properties
Lookup properties are read-only, computed properties which contain entity primary key Edm.Guid data for one or more corresponding single-valued navigation properties. More information: Lookup properties and Retrieve data about lookup properties.
| Name | Single-valued navigation property | Description |
|---|---|---|
| _businessunitid_value | businessunitid |
Unique identifier of the business unit with which the role is associated. |
| _createdby_value | createdby |
Unique identifier of the user who created the role. |
| _createdonbehalfby_value | createdonbehalfby |
Unique identifier of the delegate user who created the role. |
| _modifiedby_value | modifiedby |
Unique identifier of the user who last modified the role. |
| _modifiedonbehalfby_value | modifiedonbehalfby |
Unique identifier of the delegate user who last modified the role. |
| _parentroleid_value | parentroleid |
Unique identifier of the parent role. |
| _parentrootroleid_value | parentrootroleid |
Unique identifier of the parent root role. |
| _roletemplateid_value | roletemplateid |
Unique identifier of the role template that is associated with the role. |
Single-valued navigation properties
Single-valued navigation properties represent lookup fields where a single entity can be referenced. Each single-valued navigation property has a corresponding partner collection-valued navigation property on the related entity.
| Name | Type | Partner |
|---|---|---|
| businessunitid | businessunit | business_unit_roles |
| createdby | systemuser | lk_rolebase_createdby |
| createdonbehalfby | systemuser | lk_role_createdonbehalfby |
| modifiedby | systemuser | lk_rolebase_modifiedby |
| modifiedonbehalfby | systemuser | lk_role_modifiedonbehalfby |
| organizationid_organization | organization | organization_roles |
| parentroleid | role | role_parent_role |
| parentrootroleid | role | role_parent_root_role |
| roletemplateid | roletemplate | role_template_roles |
| solution_role | solution | solution_role |
Collection-valued navigation properties
Collection-valued navigation properties represent collections of entities which may represent either a one-to-many (1:N) or many-to-many (N:N) relationship between the entities.
| Name | Type | Partner |
|---|---|---|
| applicationuserrole | applicationuser | applicationuserrole |
| appmoduleroles_association | appmodule | appmoduleroles_association |
| Role_AsyncOperations | asyncoperation | regardingobjectid_role |
| Role_BulkDeleteFailures | bulkdeletefailure | regardingobjectid_role |
| role_parent_role | role | parentroleid |
| role_parent_root_role | role | parentrootroleid |
| Role_SyncErrors | syncerror | regardingobjectid_role_syncerror |
| roleprivileges_association | privilege | roleprivileges_association |
| systemuserroles_association | systemuser | systemuserroles_association |
| teamroles_association | team | teamroles_association |
Operations
The following operations can be used with the role entity type.
| Name | Binding |
|---|---|
| AddPrivilegesRole | Entity |
| RemovePrivilegeRole | Entity |
| ReplacePrivilegesRole | Entity |
| RetrieveAadUserRoles | Not Bound |
| RetrieveRolePrivilegesRole | Not Bound |
Solutions
The following solutions include the role entity type.
| Name | Description |
|---|---|
| System Solution | Internal CRM System Solution |
| AuthorizationCore | Authorization Core solution |