зеркало из https://github.com/Azure/AzureGraph.git
fix outdated links
This commit is contained in:
Родитель
13682de9d7
Коммит
983aaaaaa7
|
@ -7,3 +7,4 @@
|
||||||
CONTRIBUTING.md
|
CONTRIBUTING.md
|
||||||
^LICENSE\.md$
|
^LICENSE\.md$
|
||||||
^\.github$
|
^\.github$
|
||||||
|
^SECURITY.md$
|
||||||
|
|
|
@ -5,7 +5,7 @@ Authors@R: c(
|
||||||
person("Hong", "Ooi", , "hongooi73@gmail.com", role = c("aut", "cre")),
|
person("Hong", "Ooi", , "hongooi73@gmail.com", role = c("aut", "cre")),
|
||||||
person("Microsoft", role="cph")
|
person("Microsoft", role="cph")
|
||||||
)
|
)
|
||||||
Description: A simple interface to the 'Microsoft Graph' API <https://docs.microsoft.com/en-us/graph/overview>. 'Graph' is a comprehensive framework for accessing data in various online Microsoft services. This package was originally intended to provide an R interface only to the 'Azure Active Directory' part, with a view to supporting interoperability of R and 'Azure': users, groups, registered apps and service principals. However it has since been expanded into a more general tool for interacting with Graph. Part of the 'AzureR' family of packages.
|
Description: A simple interface to the 'Microsoft Graph' API <https://learn.microsoft.com/en-us/graph/overview>. 'Graph' is a comprehensive framework for accessing data in various online Microsoft services. This package was originally intended to provide an R interface only to the 'Azure Active Directory' part, with a view to supporting interoperability of R and 'Azure': users, groups, registered apps and service principals. However it has since been expanded into a more general tool for interacting with Graph. Part of the 'AzureR' family of packages.
|
||||||
URL: https://github.com/Azure/AzureGraph https://github.com/Azure/AzureR
|
URL: https://github.com/Azure/AzureGraph https://github.com/Azure/AzureR
|
||||||
BugReports: https://github.com/Azure/AzureGraph/issues
|
BugReports: https://github.com/Azure/AzureGraph/issues
|
||||||
License: MIT + file LICENSE
|
License: MIT + file LICENSE
|
||||||
|
|
|
@ -27,11 +27,11 @@
|
||||||
#' @section Initialization:
|
#' @section Initialization:
|
||||||
#' Creating new objects of this class should be done via the `create_app` and `get_app` methods of the [ms_graph] class. Calling the `new()` method for this class only constructs the R object; it does not call the Microsoft Graph API to create the actual app.
|
#' Creating new objects of this class should be done via the `create_app` and `get_app` methods of the [ms_graph] class. Calling the `new()` method for this class only constructs the R object; it does not call the Microsoft Graph API to create the actual app.
|
||||||
#'
|
#'
|
||||||
#' [Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [REST API reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-beta)
|
#' [REST API reference](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-beta)
|
||||||
#'
|
#'
|
||||||
#' @section List methods:
|
#' @section List methods:
|
||||||
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' 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.
|
||||||
#' @seealso
|
#' @seealso
|
||||||
|
|
|
@ -21,8 +21,8 @@
|
||||||
#' @seealso
|
#' @seealso
|
||||||
#' [ms_graph], [az_user], [az_object]
|
#' [ms_graph], [az_user], [az_object]
|
||||||
#'
|
#'
|
||||||
#' [Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [REST API reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
#' [REST API reference](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
||||||
#'
|
#'
|
||||||
#' @format An R6 object of class `az_device`, inheriting from `az_object`.
|
#' @format An R6 object of class `az_device`, inheriting from `az_object`.
|
||||||
#' @export
|
#' @export
|
||||||
|
|
|
@ -20,14 +20,14 @@
|
||||||
#' Currently support for directory roles is limited. Objects of this class should not be initialized directly.
|
#' Currently support for directory roles is limited. Objects of this class should not be initialized directly.
|
||||||
#'
|
#'
|
||||||
#' @section List methods:
|
#' @section List methods:
|
||||||
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' 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.
|
||||||
#' @seealso
|
#' @seealso
|
||||||
#' [ms_graph], [az_user]
|
#' [ms_graph], [az_user]
|
||||||
#'
|
#'
|
||||||
#' [Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [REST API reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
#' [REST API reference](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
||||||
#'
|
#'
|
||||||
#' @format An R6 object of class `az_directory_role`, inheriting from `az_object`.
|
#' @format An R6 object of class `az_directory_role`, inheriting from `az_object`.
|
||||||
#' @export
|
#' @export
|
||||||
|
|
|
@ -21,14 +21,14 @@
|
||||||
#' Creating new objects of this class should be done via the `create_group` and `get_group` methods of the [ms_graph] and [az_app] classes. Calling the `new()` method for this class only constructs the R object; it does not call the Microsoft Graph API to create the actual group.
|
#' Creating new objects of this class should be done via the `create_group` and `get_group` methods of the [ms_graph] and [az_app] classes. Calling the `new()` method for this class only constructs the R object; it does not call the Microsoft Graph API to create the actual group.
|
||||||
#'
|
#'
|
||||||
#' @section List methods:
|
#' @section List methods:
|
||||||
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' 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.
|
||||||
#' @seealso
|
#' @seealso
|
||||||
#' [ms_graph], [az_app], [az_user], [az_object]
|
#' [ms_graph], [az_app], [az_user], [az_object]
|
||||||
#'
|
#'
|
||||||
#' [Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [REST API reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
#' [REST API reference](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
||||||
#'
|
#'
|
||||||
#' @examples
|
#' @examples
|
||||||
#' \dontrun{
|
#' \dontrun{
|
||||||
|
|
|
@ -21,14 +21,14 @@
|
||||||
#' Objects of this class should not be created directly. Instead, create an object of the appropriate subclass: [az_app], [az_service_principal], [az_user], [az_group].
|
#' Objects of this class should not be created directly. Instead, create an object of the appropriate subclass: [az_app], [az_service_principal], [az_user], [az_group].
|
||||||
#'
|
#'
|
||||||
#' @section List methods:
|
#' @section List methods:
|
||||||
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' 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.
|
||||||
#' @seealso
|
#' @seealso
|
||||||
#' [ms_graph], [az_app], [az_service_principal], [az_user], [az_group]
|
#' [ms_graph], [az_app], [az_service_principal], [az_user], [az_group]
|
||||||
#'
|
#'
|
||||||
#' [Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [REST API reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
#' [REST API reference](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
||||||
#'
|
#'
|
||||||
#' @format An R6 object of class `az_object`, inheriting from `ms_object`.
|
#' @format An R6 object of class `az_object`, inheriting from `ms_object`.
|
||||||
#' @export
|
#' @export
|
||||||
|
|
|
@ -21,8 +21,8 @@
|
||||||
#' @seealso
|
#' @seealso
|
||||||
#' [ms_graph], [az_app], [az_object]
|
#' [ms_graph], [az_app], [az_object]
|
||||||
#'
|
#'
|
||||||
#' [Azure Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Azure Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [REST API reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
#' [REST API reference](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
||||||
#'
|
#'
|
||||||
#' @format An R6 object of class `az_service_principal`, inheriting from `az_object`.
|
#' @format An R6 object of class `az_service_principal`, inheriting from `az_object`.
|
||||||
#' @export
|
#' @export
|
||||||
|
|
|
@ -25,14 +25,14 @@
|
||||||
#' Creating new objects of this class should be done via the `create_user` and `get_user` methods of the [ms_graph] and [az_app] classes. Calling the `new()` method for this class only constructs the R object; it does not call the Microsoft Graph API to create the actual user account.
|
#' Creating new objects of this class should be done via the `create_user` and `get_user` methods of the [ms_graph] and [az_app] classes. Calling the `new()` method for this class only constructs the R object; it does not call the Microsoft Graph API to create the actual user account.
|
||||||
#'
|
#'
|
||||||
#' @section List methods:
|
#' @section List methods:
|
||||||
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' 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.
|
||||||
#' @seealso
|
#' @seealso
|
||||||
#' [ms_graph], [az_app], [az_group], [az_device], [az_object]
|
#' [ms_graph], [az_app], [az_group], [az_device], [az_object]
|
||||||
#'
|
#'
|
||||||
#' [Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [REST API reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
#' [REST API reference](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
||||||
#'
|
#'
|
||||||
#' @examples
|
#' @examples
|
||||||
#' \dontrun{
|
#' \dontrun{
|
||||||
|
|
|
@ -19,8 +19,8 @@
|
||||||
#' @seealso
|
#' @seealso
|
||||||
#' [call_batch_endpoint]
|
#' [call_batch_endpoint]
|
||||||
#'
|
#'
|
||||||
#' [Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [Batch endpoint documentation](https://docs.microsoft.com/en-us/graph/json-batching)
|
#' [Batch endpoint documentation](https://learn.microsoft.com/en-us/graph/json-batching)
|
||||||
#'
|
#'
|
||||||
#' @examples
|
#' @examples
|
||||||
#' graph_request$new("me")
|
#' graph_request$new("me")
|
||||||
|
@ -122,8 +122,8 @@ public=list(
|
||||||
#' @seealso
|
#' @seealso
|
||||||
#' [graph_request], [call_graph_endpoint]
|
#' [graph_request], [call_graph_endpoint]
|
||||||
#'
|
#'
|
||||||
#' [Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [Batch endpoint documentation](https://docs.microsoft.com/en-us/graph/json-batching)
|
#' [Batch endpoint documentation](https://learn.microsoft.com/en-us/graph/json-batching)
|
||||||
#'
|
#'
|
||||||
#' [OData documentation on batch requests](https://docs.oasis-open.org/odata/odata-json-format/v4.01/odata-json-format-v4.01.html#sec_BatchRequestsandResponses)
|
#' [OData documentation on batch requests](https://docs.oasis-open.org/odata/odata-json-format/v4.01/odata-json-format-v4.01.html#sec_BatchRequestsandResponses)
|
||||||
#'
|
#'
|
||||||
|
|
|
@ -40,8 +40,8 @@
|
||||||
#'
|
#'
|
||||||
#' [AzureAuth vignette on authentication scenarios](https://cran.r-project.org/package=AzureAuth/vignettes/scenarios.html)
|
#' [AzureAuth vignette on authentication scenarios](https://cran.r-project.org/package=AzureAuth/vignettes/scenarios.html)
|
||||||
#'
|
#'
|
||||||
#' [Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [REST API reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
#' [REST API reference](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
||||||
#'
|
#'
|
||||||
#' @examples
|
#' @examples
|
||||||
#' \dontrun{
|
#' \dontrun{
|
||||||
|
|
|
@ -49,15 +49,15 @@
|
||||||
#' A new app will also have a service principal created for it by default. To disable this, set `create_service_principal=FALSE`.
|
#' A new app will also have a service principal created for it by default. To disable this, set `create_service_principal=FALSE`.
|
||||||
#'
|
#'
|
||||||
#' @section List methods:
|
#' @section List methods:
|
||||||
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' 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.
|
||||||
#'
|
#'
|
||||||
#' @seealso
|
#' @seealso
|
||||||
#' [create_graph_login], [get_graph_login]
|
#' [create_graph_login], [get_graph_login]
|
||||||
#'
|
#'
|
||||||
#' [Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [REST API reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
#' [REST API reference](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
||||||
#'
|
#'
|
||||||
#' @examples
|
#' @examples
|
||||||
#' \dontrun{
|
#' \dontrun{
|
||||||
|
|
|
@ -32,8 +32,8 @@
|
||||||
#' @seealso
|
#' @seealso
|
||||||
#' [ms_object], [extract_list_values]
|
#' [ms_object], [extract_list_values]
|
||||||
#'
|
#'
|
||||||
#' [Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [Paging documentation](https://docs.microsoft.com/en-us/graph/paging)
|
#' [Paging documentation](https://learn.microsoft.com/en-us/graph/paging)
|
||||||
#'
|
#'
|
||||||
#' @examples
|
#' @examples
|
||||||
#' \dontrun{
|
#' \dontrun{
|
||||||
|
|
|
@ -20,7 +20,7 @@
|
||||||
#' Objects of this class should not be created directly. Instead, create an object of the appropriate subclass.
|
#' Objects of this class should not be created directly. Instead, create an object of the appropriate subclass.
|
||||||
#'
|
#'
|
||||||
#' @section List methods:
|
#' @section List methods:
|
||||||
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' All `list_*` methods have `filter` and `n` arguments to limit the number of results. The former should be an [OData expression](https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter) 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.
|
#' 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.
|
||||||
#'
|
#'
|
||||||
|
@ -53,8 +53,8 @@
|
||||||
#' @seealso
|
#' @seealso
|
||||||
#' [ms_graph], [az_object], [ms_graph_pager], [extract_list_values]
|
#' [ms_graph], [az_object], [ms_graph_pager], [extract_list_values]
|
||||||
#'
|
#'
|
||||||
#' [Microsoft Graph overview](https://docs.microsoft.com/en-us/graph/overview),
|
#' [Microsoft Graph overview](https://learn.microsoft.com/en-us/graph/overview),
|
||||||
#' [REST API reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
#' [REST API reference](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0)
|
||||||
#'
|
#'
|
||||||
#' @format An R6 object of class `ms_object`.
|
#' @format An R6 object of class `ms_object`.
|
||||||
#' @export
|
#' @export
|
||||||
|
|
|
@ -4,7 +4,7 @@
|
||||||
![Downloads](https://cranlogs.r-pkg.org/badges/AzureGraph)
|
![Downloads](https://cranlogs.r-pkg.org/badges/AzureGraph)
|
||||||
![R-CMD-check](https://github.com/Azure/AzureGraph/workflows/R-CMD-check/badge.svg)
|
![R-CMD-check](https://github.com/Azure/AzureGraph/workflows/R-CMD-check/badge.svg)
|
||||||
|
|
||||||
A simple interface to the [Microsoft Graph API](https://docs.microsoft.com/en-us/graph/overview). The companion package to [AzureRMR](https://github.com/Azure/AzureRMR) and [AzureAuth](https://github.com/Azure/AzureAuth).
|
A simple interface to the [Microsoft Graph API](https://learn.microsoft.com/en-us/graph/overview). The companion package to [AzureRMR](https://github.com/Azure/AzureRMR) and [AzureAuth](https://github.com/Azure/AzureAuth).
|
||||||
|
|
||||||
Microsoft Graph is a comprehensive framework for accessing data in various online Microsoft services. Currently, this package aims to provide an R interface only to the Azure Active Directory part, with a view to supporting interoperability of R and Azure: users, groups, registered apps and service principals. Like AzureRMR, it could potentially be extended to cover other services.
|
Microsoft Graph is a comprehensive framework for accessing data in various online Microsoft services. Currently, this package aims to provide an R interface only to the Azure Active Directory part, with a view to supporting interoperability of R and Azure: users, groups, registered apps and service principals. Like AzureRMR, it could potentially be extended to cover other services.
|
||||||
|
|
||||||
|
|
|
@ -44,13 +44,13 @@ Base class representing an AAD app.
|
||||||
|
|
||||||
Creating new objects of this class should be done via the \code{create_app} and \code{get_app} methods of the \link{ms_graph} class. Calling the \code{new()} method for this class only constructs the R object; it does not call the Microsoft Graph API to create the actual app.
|
Creating new objects of this class should be done via the \code{create_app} and \code{get_app} methods of the \link{ms_graph} class. Calling the \code{new()} method for this class only constructs the R object; it does not call the Microsoft Graph API to create the actual app.
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-beta}{REST API reference}
|
\href{https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-beta}{REST API reference}
|
||||||
}
|
}
|
||||||
|
|
||||||
\section{List methods}{
|
\section{List methods}{
|
||||||
|
|
||||||
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{ms_graph_pager} iterator object is returned instead to allow manual iteration over the results.
|
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{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.
|
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.
|
||||||
}
|
}
|
||||||
|
|
|
@ -39,6 +39,6 @@ Create objects of this class via the \code{list_registered_devices()} and \code{
|
||||||
\seealso{
|
\seealso{
|
||||||
\link{ms_graph}, \link{az_user}, \link{az_object}
|
\link{ms_graph}, \link{az_user}, \link{az_object}
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
\href{https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
||||||
}
|
}
|
||||||
|
|
|
@ -39,7 +39,7 @@ Currently support for directory roles is limited. Objects of this class should n
|
||||||
|
|
||||||
\section{List methods}{
|
\section{List methods}{
|
||||||
|
|
||||||
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{ms_graph_pager} iterator object is returned instead to allow manual iteration over the results.
|
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{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.
|
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.
|
||||||
}
|
}
|
||||||
|
@ -47,6 +47,6 @@ Support in the underlying Graph API for OData queries is patchy. Not all endpoin
|
||||||
\seealso{
|
\seealso{
|
||||||
\link{ms_graph}, \link{az_user}
|
\link{ms_graph}, \link{az_user}
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
\href{https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
||||||
}
|
}
|
||||||
|
|
|
@ -40,7 +40,7 @@ Creating new objects of this class should be done via the \code{create_group} an
|
||||||
|
|
||||||
\section{List methods}{
|
\section{List methods}{
|
||||||
|
|
||||||
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{ms_graph_pager} iterator object is returned instead to allow manual iteration over the results.
|
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{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.
|
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.
|
||||||
}
|
}
|
||||||
|
@ -69,6 +69,6 @@ pager$value
|
||||||
\seealso{
|
\seealso{
|
||||||
\link{ms_graph}, \link{az_app}, \link{az_user}, \link{az_object}
|
\link{ms_graph}, \link{az_app}, \link{az_user}, \link{az_object}
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
\href{https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
||||||
}
|
}
|
||||||
|
|
|
@ -40,7 +40,7 @@ Objects of this class should not be created directly. Instead, create an object
|
||||||
|
|
||||||
\section{List methods}{
|
\section{List methods}{
|
||||||
|
|
||||||
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{ms_graph_pager} iterator object is returned instead to allow manual iteration over the results.
|
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{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.
|
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.
|
||||||
}
|
}
|
||||||
|
@ -48,6 +48,6 @@ Support in the underlying Graph API for OData queries is patchy. Not all endpoin
|
||||||
\seealso{
|
\seealso{
|
||||||
\link{ms_graph}, \link{az_app}, \link{az_service_principal}, \link{az_user}, \link{az_group}
|
\link{ms_graph}, \link{az_app}, \link{az_service_principal}, \link{az_user}, \link{az_group}
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
\href{https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
||||||
}
|
}
|
||||||
|
|
|
@ -39,6 +39,6 @@ Creating new objects of this class should be done via the \code{create_service_p
|
||||||
\seealso{
|
\seealso{
|
||||||
\link{ms_graph}, \link{az_app}, \link{az_object}
|
\link{ms_graph}, \link{az_app}, \link{az_object}
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Azure Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Azure Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
\href{https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
||||||
}
|
}
|
||||||
|
|
|
@ -44,7 +44,7 @@ Creating new objects of this class should be done via the \code{create_user} and
|
||||||
|
|
||||||
\section{List methods}{
|
\section{List methods}{
|
||||||
|
|
||||||
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{ms_graph_pager} iterator object is returned instead to allow manual iteration over the results.
|
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{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.
|
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.
|
||||||
}
|
}
|
||||||
|
@ -81,6 +81,6 @@ pager$value
|
||||||
\seealso{
|
\seealso{
|
||||||
\link{ms_graph}, \link{az_app}, \link{az_group}, \link{az_device}, \link{az_object}
|
\link{ms_graph}, \link{az_app}, \link{az_group}, \link{az_device}, \link{az_object}
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
\href{https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
||||||
}
|
}
|
||||||
|
|
|
@ -67,8 +67,8 @@ call_batch_endpoint(token, list(req_get, req_create, req_get), depends_on=c("2"=
|
||||||
\seealso{
|
\seealso{
|
||||||
\link{graph_request}, \link{call_graph_endpoint}
|
\link{graph_request}, \link{call_graph_endpoint}
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/json-batching}{Batch endpoint documentation}
|
\href{https://learn.microsoft.com/en-us/graph/json-batching}{Batch endpoint documentation}
|
||||||
|
|
||||||
\href{https://docs.oasis-open.org/odata/odata-json-format/v4.01/odata-json-format-v4.01.html#sec_BatchRequestsandResponses}{OData documentation on batch requests}
|
\href{https://docs.oasis-open.org/odata/odata-json-format/v4.01/odata-json-format-v4.01.html#sec_BatchRequestsandResponses}{OData documentation on batch requests}
|
||||||
}
|
}
|
||||||
|
|
|
@ -105,6 +105,6 @@ create_graph_login("consumers") # requires AzureAuth 1.3.0
|
||||||
|
|
||||||
\href{https://cran.r-project.org/package=AzureAuth/vignettes/scenarios.html}{AzureAuth vignette on authentication scenarios}
|
\href{https://cran.r-project.org/package=AzureAuth/vignettes/scenarios.html}{AzureAuth vignette on authentication scenarios}
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
\href{https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
||||||
}
|
}
|
||||||
|
|
|
@ -52,6 +52,6 @@ graph_request$new("me/messages",
|
||||||
\seealso{
|
\seealso{
|
||||||
\link{call_batch_endpoint}
|
\link{call_batch_endpoint}
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/json-batching}{Batch endpoint documentation}
|
\href{https://learn.microsoft.com/en-us/graph/json-batching}{Batch endpoint documentation}
|
||||||
}
|
}
|
||||||
|
|
|
@ -67,7 +67,7 @@ A new app will also have a service principal created for it by default. To disab
|
||||||
|
|
||||||
\section{List methods}{
|
\section{List methods}{
|
||||||
|
|
||||||
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{ms_graph_pager} iterator object is returned instead to allow manual iteration over the results.
|
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{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.
|
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.
|
||||||
}
|
}
|
||||||
|
@ -125,6 +125,6 @@ gr$list_groups(filter="groupTypes/any(c:c eq 'Unified')")
|
||||||
\seealso{
|
\seealso{
|
||||||
\link{create_graph_login}, \link{get_graph_login}
|
\link{create_graph_login}, \link{get_graph_login}
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
\href{https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
||||||
}
|
}
|
||||||
|
|
|
@ -90,6 +90,6 @@ while(pager$has_data())
|
||||||
\seealso{
|
\seealso{
|
||||||
\link{ms_object}, \link{extract_list_values}
|
\link{ms_object}, \link{extract_list_values}
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/paging}{Paging documentation}
|
\href{https://learn.microsoft.com/en-us/graph/paging}{Paging documentation}
|
||||||
}
|
}
|
||||||
|
|
|
@ -39,7 +39,7 @@ Objects of this class should not be created directly. Instead, create an object
|
||||||
|
|
||||||
\section{List methods}{
|
\section{List methods}{
|
||||||
|
|
||||||
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{ms_graph_pager} iterator object is returned instead to allow manual iteration over the results.
|
All \verb{list_*} methods have \code{filter} and \code{n} arguments to limit the number of results. The former should be an \href{https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter}{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 \code{filter=NULL} and \code{n=Inf}. If \code{n=NULL}, the \code{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.
|
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.
|
||||||
}
|
}
|
||||||
|
@ -81,6 +81,6 @@ The following methods are private and \strong{deprecated}, and form the older Az
|
||||||
\seealso{
|
\seealso{
|
||||||
\link{ms_graph}, \link{az_object}, \link{ms_graph_pager}, \link{extract_list_values}
|
\link{ms_graph}, \link{az_object}, \link{ms_graph_pager}, \link{extract_list_values}
|
||||||
|
|
||||||
\href{https://docs.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
\href{https://learn.microsoft.com/en-us/graph/overview}{Microsoft Graph overview},
|
||||||
\href{https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
\href{https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0}{REST API reference}
|
||||||
}
|
}
|
||||||
|
|
|
@ -85,13 +85,13 @@ You can create a new app registration using any of the usual methods. For exampl
|
||||||
|
|
||||||
Once the app registration has been created, note the app ID and, if applicable, the client secret. The latter can't be viewed after app creation, so make sure you note its value now.
|
Once the app registration has been created, note the app ID and, if applicable, the client secret. The latter can't be viewed after app creation, so make sure you note its value now.
|
||||||
|
|
||||||
It's also possible to authenticate with a **client certificate (public key)**, but this is more complex and we won't go into it here. For more details, see the [Azure Active Directory documentation](https://docs.microsoft.com/en-au/azure/active-directory/develop/v2-oauth2-client-creds-grant-flow) and the [AzureAuth intro vignette](https://cran.r-project.org/package=AzureAuth/vignettes/token.html).
|
It's also possible to authenticate with a **client certificate (public key)**, but this is more complex and we won't go into it here. For more details, see the [Azure Active Directory documentation](https://learn.microsoft.com/en-au/azure/active-directory/develop/v2-oauth2-client-creds-grant-flow) and the [AzureAuth intro vignette](https://cran.r-project.org/package=AzureAuth/vignettes/token.html).
|
||||||
|
|
||||||
### Set the app permissions
|
### Set the app permissions
|
||||||
|
|
||||||
For your app to be useful, you must give it the appropriate permisssions for the Microsoft Graph API. You can set this by going to the "API permissions" pane for your app registration, then clicking on "Add a permission". Choose the Microsoft Graph API, and then enable the permissions that you need.
|
For your app to be useful, you must give it the appropriate permisssions for the Microsoft Graph API. You can set this by going to the "API permissions" pane for your app registration, then clicking on "Add a permission". Choose the Microsoft Graph API, and then enable the permissions that you need.
|
||||||
|
|
||||||
- For interactive use, make sure that you enable the _delegated_ permissions. These apply when a logged-in user is present. [See the documentation](https://docs.microsoft.com/en-us/graph/auth/auth-concepts#microsoft-graph-permissions) for how permissions and user roles interact; essentially, if a user wants to use AzureGraph to do an action, they must have the correct role _and_ the app registration must have the correct permission.
|
- For interactive use, make sure that you enable the _delegated_ permissions. These apply when a logged-in user is present. [See the documentation](https://learn.microsoft.com/en-us/graph/auth/auth-concepts#microsoft-graph-permissions) for how permissions and user roles interact; essentially, if a user wants to use AzureGraph to do an action, they must have the correct role _and_ the app registration must have the correct permission.
|
||||||
- It's highly recommended to enable the "offline_access" permission for an interactive app, as this is necessary to obtain refresh tokens. Without these, a user must reauthenticate each time their access token expires, which by default is after one hour.
|
- It's highly recommended to enable the "offline_access" permission for an interactive app, as this is necessary to obtain refresh tokens. Without these, a user must reauthenticate each time their access token expires, which by default is after one hour.
|
||||||
- For non-interactive use, enable the _application_ permissions. These are more powerful since there is no user role that can moderate what AzureGraph can do, so assign application permissions with caution.
|
- For non-interactive use, enable the _application_ permissions. These are more powerful since there is no user role that can moderate what AzureGraph can do, so assign application permissions with caution.
|
||||||
|
|
||||||
|
|
|
@ -73,7 +73,7 @@ Having defined your new class, call `register_graph_class` so that AzureGraph be
|
||||||
|
|
||||||
`register_graph_class` takes 3 arguments:
|
`register_graph_class` takes 3 arguments:
|
||||||
|
|
||||||
- The name of the object class, as it appears in the [Microsoft Graph online documentation](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0).
|
- The name of the object class, as it appears in the [Microsoft Graph online documentation](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0).
|
||||||
- The R6 class generator object, as defined in the previous section.
|
- The R6 class generator object, as defined in the previous section.
|
||||||
- A check function which takes a list of properties (as returned by the Graph API) and returns TRUE/FALSE based on whether the properties are for an object of your class. This is necessary as some Graph calls that return lists of objects do not always include explicit metadata indicating the type of each object, hence the type must be inferred from the properties.
|
- A check function which takes a list of properties (as returned by the Graph API) and returns TRUE/FALSE based on whether the properties are for an object of your class. This is necessary as some Graph calls that return lists of objects do not always include explicit metadata indicating the type of each object, hence the type must be inferred from the properties.
|
||||||
|
|
||||||
|
|
|
@ -8,7 +8,7 @@ vignette: >
|
||||||
%\VignetteEncoding{utf8}
|
%\VignetteEncoding{utf8}
|
||||||
---
|
---
|
||||||
|
|
||||||
[Microsoft Graph](https://docs.microsoft.com/en-us/graph/overview) is a comprehensive framework for accessing data in various online Microsoft services, including Azure Active Directory (AAD), Office 365, OneDrive, Teams, and more. AzureGraph is a simple R6-based interface to the Graph REST API, and is the companion package to [AzureRMR](https://github.com/Azure/AzureRMR) and [AzureAuth](https://github.com/Azure/AzureAuth).
|
[Microsoft Graph](https://learn.microsoft.com/en-us/graph/overview) is a comprehensive framework for accessing data in various online Microsoft services, including Azure Active Directory (AAD), Office 365, OneDrive, Teams, and more. AzureGraph is a simple R6-based interface to the Graph REST API, and is the companion package to [AzureRMR](https://github.com/Azure/AzureRMR) and [AzureAuth](https://github.com/Azure/AzureAuth).
|
||||||
|
|
||||||
Currently, AzureGraph aims to provide an R interface only to the AAD part, with a view to supporting R interoperability with Azure: registered apps and service principals, users and groups. However, it can be extended to support other services; for more information, see the "Extending AzureGraph" vignette.
|
Currently, AzureGraph aims to provide an R interface only to the AAD part, with a view to supporting R interoperability with Azure: registered apps and service principals, users and groups. However, it can be extended to support other services; for more information, see the "Extending AzureGraph" vignette.
|
||||||
|
|
||||||
|
@ -83,7 +83,7 @@ names(grp$properties)
|
||||||
#> ...
|
#> ...
|
||||||
```
|
```
|
||||||
|
|
||||||
You can apply a filter to the `list_users` and `list_groups` methods, to cut down on the number of results. The filter should be a supported [OData expression](https://docs.microsoft.com/en-us/graph/query-parameters#filter-parameter). For example, this will filter the list of users down to your own account:
|
You can apply a filter to the `list_users` and `list_groups` methods, to cut down on the number of results. The filter should be a supported [OData expression](https://learn.microsoft.com/en-us/graph/query-parameters#filter-parameter). For example, this will filter the list of users down to your own account:
|
||||||
|
|
||||||
```r
|
```r
|
||||||
# get my own name
|
# get my own name
|
||||||
|
@ -216,5 +216,5 @@ me$do_operation("drive/root/children")
|
||||||
|
|
||||||
See the following links on Microsoft Docs for more information.
|
See the following links on Microsoft Docs for more information.
|
||||||
|
|
||||||
- [Microsoft Graph](https://docs.microsoft.com/en-us/graph/overview)
|
- [Microsoft Graph](https://learn.microsoft.com/en-us/graph/overview)
|
||||||
- [Graph REST API (beta)](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-beta)
|
- [Graph REST API (beta)](https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-beta)
|
||||||
|
|
Загрузка…
Ссылка в новой задаче