az_directory_role: Directory role

az_directory_roleR Documentation

Directory role


Class representing a role in Azure Active Directory.


An R6 object of class az_directory_role, inheriting from az_object.


  • token: The token used to authenticate with the Graph host.

  • tenant: The Azure Active Directory tenant for this role.

  • type: always "directory role" for a directory role object.

  • properties: The item properties.


  • new(...): Initialize a new object. Do not call this directly; see 'Initialization' below.

  • delete(confirm=TRUE): Delete this item. By default, ask for confirmation first.

  • update(...): Update the item's properties in Microsoft Graph.

  • do_operation(...): Carry out an arbitrary operation on the item.

  • sync_fields(): Synchronise the R object with the item metadata in Microsoft Graph.

  • list_members(filter=NULL, n=Inf): Return a list of all members of this group.


Currently support for directory roles is limited. Objects of this class should not be initialized directly.

List methods

All list_* methods have filter and n arguments to limit the number of results. The former should be an OData expression as a string to filter the result set on. The latter should be a number setting the maximum number of (filtered) results to return. The default values are filter=NULL and n=Inf. If n=NULL, the ms_graph_pager iterator object is returned instead to allow manual iteration over the results.

Support in the underlying Graph API for OData queries is patchy. Not all endpoints that return lists of objects support filtering, and if they do, they may not allow all of the defined operators. If your filtering expression results in an error, you can carry out the operation without filtering and then filter the results on the client side.

See Also

ms_graph, az_user

Microsoft Graph overview, REST API reference

AzureGraph documentation built on March 18, 2022, 8:04 p.m.