update doc urls

DESCRIPTION

@@ -28,4 +28,4 @@ Suggests:
     httpuv,
     AzureStor
 Roxygen: list(markdown=TRUE, r6=FALSE, old_usage=TRUE)
-RoxygenNote: 7.1.1
+RoxygenNote: 7.2.1

R/az_login.R

@@ -41,12 +41,12 @@
 #' @seealso
 #' [az_rm], [AzureAuth::get_azure_token] for more details on authentication methods, [AzureGraph::create_graph_login] for the corresponding function to create a Microsoft Graph login client
 #'
-#' [Azure Resource Manager overview](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview),
-#' [REST API reference](https://docs.microsoft.com/en-us/rest/api/resources/)
+#' [Azure Resource Manager overview](https://learn.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview),
+#' [REST API reference](https://learn.microsoft.com/en-us/rest/api/resources/)
 #'
-#' [Authentication in Azure Active Directory](https://docs.microsoft.com/en-us/azure/active-directory/develop/authentication-scenarios)
+#' [Authentication in Azure Active Directory](https://learn.microsoft.com/en-us/azure/active-directory/develop/authentication-scenarios)
 #'
-#' [Azure CLI documentation](https://docs.microsoft.com/en-us/cli/azure/?view=azure-cli-latest)
+#' [Azure CLI documentation](https://learn.microsoft.com/en-us/cli/azure/?view=azure-cli-latest)
 #'
 #' @examples
 #' \dontrun{

R/az_resgroup.R

@@ -7,15 +7,15 @@
 #' - `new(token, subscription, id, ...)`: Initialize a resource group object. See 'Initialization' for more details.
 #' - `delete(confirm=TRUE)`: Delete this resource group, after a confirmation check. This is asynchronous: while the method returns immediately, the delete operation continues on the host in the background. For resource groups containing a large number of deployed resources, this may take some time to complete.
 #' - `sync_fields()`: Synchronise the R object with the resource group it represents in Azure.
-#' - `list_templates(filter, top)`: List deployed templates in this resource group. `filter` and `top` are optional arguments to filter the results; see the [Azure documentation](https://docs.microsoft.com/en-us/rest/api/resources/deployments/listbyresourcegroup) for more details. If `top` is specified, the returned list will have a maximum of this many items.
+#' - `list_templates(filter, top)`: List deployed templates in this resource group. `filter` and `top` are optional arguments to filter the results; see the [Azure documentation](https://learn.microsoft.com/en-us/rest/api/resources/deployments/listbyresourcegroup) for more details. If `top` is specified, the returned list will have a maximum of this many items.
 #' - `get_template(name)`: Return an object representing an existing template.
 #' - `deploy_template(...)`: Deploy a new template. See 'Templates' for more details. By default, AzureRMR will set the `createdBy` tag on a newly-deployed template to the value `AzureR/AzureRMR`.
 #' - `delete_template(name, confirm=TRUE, free_resources=FALSE)`: Delete a deployed template, and optionally free any resources that were created.
 #' - `get_resource(...)`: Return an object representing an existing resource. See 'Resources' for more details.
 #' - `create_resource(...)`: Create a new resource. By default, AzureRMR will set the `createdBy` tag on a newly-created resource to the value `AzureR/AzureRMR`.
 #' - `delete_resource(..., confirm=TRUE, wait=FALSE)`: Delete an existing resource. Optionally wait for the delete to finish.
 #' - `resource_exists(...)`: Check if a resource exists.
-#' - `list_resources(filter, expand, top)`: Return a list of resource group objects for this subscription. `filter`, `expand` and `top` are optional arguments to filter the results; see the [Azure documentation](https://docs.microsoft.com/en-us/rest/api/resources/resources/list) for more details. If `top` is specified, the returned list will have a maximum of this many items.
+#' - `list_resources(filter, expand, top)`: Return a list of resource group objects for this subscription. `filter`, `expand` and `top` are optional arguments to filter the results; see the [Azure documentation](https://learn.microsoft.com/en-us/rest/api/resources/resources/list) for more details. If `top` is specified, the returned list will have a maximum of this many items.
 #' - `do_operation(...)`: Carry out an operation. See 'Operations' for more details.
 #' - `set_tags(..., keep_existing=TRUE)`: Set the tags on this resource group. The tags can be either names or name-value pairs. To delete a tag, set it to `NULL`.
 #' - `get_tags()`: Get the tags on this resource group.
@@ -74,9 +74,9 @@
 #'
 #' @seealso
 #' [az_subscription], [az_template], [az_resource],
-#' [Azure resource group overview](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview#resource-groups),
-#' [Resources API reference](https://docs.microsoft.com/en-us/rest/api/resources/resources),
-#' [Template API reference](https://docs.microsoft.com/en-us/rest/api/resources/deployments)
+#' [Azure resource group overview](https://learn.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview#resource-groups),
+#' [Resources API reference](https://learn.microsoft.com/en-us/rest/api/resources/resources),
+#' [Template API reference](https://learn.microsoft.com/en-us/rest/api/resources/deployments)
 #'
 #' For role-based access control methods, see [rbac]
 #'

R/az_resource.R

@@ -73,7 +73,7 @@
 #'
 #' @seealso
 #' [az_resource_group], [call_azure_rm], [call_azure_url],
-#' [Resources API reference](https://docs.microsoft.com/en-us/rest/api/resources/resources)
+#' [Resources API reference](https://learn.microsoft.com/en-us/rest/api/resources/resources)
 #'
 #' For role-based access control methods, see [rbac]
 #'

R/az_rm.R

@@ -41,8 +41,8 @@
 #' @seealso
 #' [create_azure_login], [get_azure_login]
 #'
-#' [Azure Resource Manager overview](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview),
-#' [REST API reference](https://docs.microsoft.com/en-us/rest/api/resources/)
+#' [Azure Resource Manager overview](https://learn.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview),
+#' [REST API reference](https://learn.microsoft.com/en-us/rest/api/resources/)
 #'
 #' @examples
 #' \dontrun{

R/az_role.R

@@ -18,7 +18,7 @@
 #' @seealso
 #' [get_role_definition], [get_role_assignment], [az_role_assignment]
 #'
-#' [Overview of role-based access control](https://docs.microsoft.com/en-us/azure/role-based-access-control/overview)
+#' [Overview of role-based access control](https://learn.microsoft.com/en-us/azure/role-based-access-control/overview)
 #'
 #' @format An R6 object of class `az_role_definition`.
 #' @export
@@ -72,7 +72,7 @@ public=list(
 #' @seealso
 #' [add_role_assignment], [get_role_assignment], [get_role_definition], [az_role_definition]
 #'
-#' [Overview of role-based access control](https://docs.microsoft.com/en-us/azure/role-based-access-control/overview)
+#' [Overview of role-based access control](https://learn.microsoft.com/en-us/azure/role-based-access-control/overview)
 #'
 #' @format An R6 object of class `az_role_assignment`.
 #' @export

R/az_subscription.R

@@ -7,12 +7,12 @@
 #' @docType class
 #' @section Methods:
 #' - `new(token, id, ...)`: Initialize a subscription object.
-#' - `list_resource_groups(filter, top)`: Return a list of resource group objects for this subscription. `filter` and `top` are optional arguments to filter the results; see the [Azure documentation](https://docs.microsoft.com/en-us/rest/api/resources/resourcegroups/list) for more details. If `top` is specified, the returned list will have a maximum of this many items.
+#' - `list_resource_groups(filter, top)`: Return a list of resource group objects for this subscription. `filter` and `top` are optional arguments to filter the results; see the [Azure documentation](https://learn.microsoft.com/en-us/rest/api/resources/resourcegroups/list) for more details. If `top` is specified, the returned list will have a maximum of this many items.
 #' - `get_resource_group(name)`: Return an object representing an existing resource group.
 #' - `create_resource_group(name, location)`: Create a new resource group in the specified region/location, and return an object representing it. By default, AzureRMR will set the `createdBy` tag on a newly-created resource group to the value `AzureR/AzureRMR`.
 #' - `delete_resource_group(name, confirm=TRUE)`: Delete a resource group, after asking for confirmation.
 #' - `resource_group_exists(name)`: Check if a resource group exists.
-#' - `list_resources(filter, expand, top)`: List all resources deployed under this subscription. `filter`, `expand` and `top` are optional arguments to filter the results; see the [Azure documentation](https://docs.microsoft.com/en-us/rest/api/resources/resources/list) for more details. If `top` is specified, the returned list will have a maximum of this many items.
+#' - `list_resources(filter, expand, top)`: List all resources deployed under this subscription. `filter`, `expand` and `top` are optional arguments to filter the results; see the [Azure documentation](https://learn.microsoft.com/en-us/rest/api/resources/resources/list) for more details. If `top` is specified, the returned list will have a maximum of this many items.
 #' - `list_locations(info=c("partial", "all"))`: List locations available. The default `info="partial"` returns a subset of the information about each location; set `info="all"` to return everything.
 #' - `get_provider_api_version(provider, type, which=1, stable_only=TRUE)`: Get the current API version for the given resource provider and type. If no resource type is supplied, returns a vector of API versions, one for each resource type for the given provider. If neither provider nor type is supplied, returns the API versions for all resources and providers. Set `stable_only=FALSE` to allow preview APIs to be returned. Set `which` to a number > 1 to return an API other than the most recent.
 #' - `do_operation(...)`: Carry out an operation. See 'Operations' for more details.
@@ -44,7 +44,7 @@
 #' AzureRMR implements a subset of the full RBAC functionality within Azure Active Directory. You can retrieve role definitions and add and remove role assignments, at the subscription, resource group and resource levels. See [rbac] for more information.
 #'
 #' @seealso
-#' [Azure Resource Manager overview](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview)
+#' [Azure Resource Manager overview](https://learn.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview)
 #'
 #' For role-based access control methods, see [rbac]
 #'

R/az_template.R

@@ -33,8 +33,8 @@
 #'
 #' @seealso
 #' [az_resource_group], [az_resource], [build_template_definition], [build_template_parameters]
-#' [Template overview](https://docs.microsoft.com/en-us/azure/templates/),
-#' [Template API reference](https://docs.microsoft.com/en-us/rest/api/resources/deployments)
+#' [Template overview](https://learn.microsoft.com/en-us/azure/templates/),
+#' [Template API reference](https://learn.microsoft.com/en-us/rest/api/resources/deployments)
 #'
 #' @examples
 #' \dontrun{

R/build_tpl_json.R

@@ -25,7 +25,7 @@
 #' @seealso
 #' [az_template], [jsonlite::toJSON]
 #'
-#' [Guide to template syntax](https://docs.microsoft.com/en-us/azure/azure-resource-manager/templates/template-syntax)
+#' [Guide to template syntax](https://learn.microsoft.com/en-us/azure/azure-resource-manager/templates/template-syntax)
 #' @examples
 #' # dummy example
 #' # note that 'resources' arg should be a _list_ of resources

R/locks.R

@@ -34,7 +34,7 @@
 #' @seealso
 #' [rbac]
 #'
-#' [Overview of management locks](https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-lock-resources)
+#' [Overview of management locks](https://learn.microsoft.com/en-us/azure/azure-resource-manager/resource-group-lock-resources)
 #'
 #' @examples
 #' \dontrun{

R/rbac.R

@@ -40,7 +40,7 @@
 #' @seealso
 #' [az_rm], [az_role_definition], [az_role_assignment]
 #'
-#' [Overview of role-based access control](https://docs.microsoft.com/en-us/azure/role-based-access-control/overview)
+#' [Overview of role-based access control](https://learn.microsoft.com/en-us/azure/role-based-access-control/overview)
 #'
 #' @examples
 #' \dontrun{

README.md

@@ -4,13 +4,13 @@
 ![Downloads](https://cranlogs.r-pkg.org/badges/AzureRMR)
 ![R-CMD-check](https://github.com/Azure/AzureRMR/workflows/R-CMD-check/badge.svg)
 
-AzureRMR is a package for interacting with Azure Resource Manager: list subscriptions, manage resource groups, deploy and delete templates and resources. It calls the Resource Manager [REST API](https://docs.microsoft.com/en-us/rest/api/resources) directly, so you don't need to have PowerShell or Python installed. Azure Active Directory OAuth tokens are obtained using the [AzureAuth](https://github.com/Azure/AzureAuth) package.
+AzureRMR is a package for interacting with Azure Resource Manager: list subscriptions, manage resource groups, deploy and delete templates and resources. It calls the Resource Manager [REST API](https://learn.microsoft.com/en-us/rest/api/resources) directly, so you don't need to have PowerShell or Python installed. Azure Active Directory OAuth tokens are obtained using the [AzureAuth](https://github.com/Azure/AzureAuth) package.
 
 The primary repo for this package is at https://github.com/Azure/AzureRMR; please submit issues and PRs there. It is also mirrored at the Cloudyr org at https://github.com/cloudyr/AzureRMR. You can install the development version of the package with `devtools::install_github("Azure/AzureRMR")`.
 
 ## Authentication
 
-Under the hood, AzureRMR uses a similar authentication process to the [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/?view=azure-cli-latest). The first time you authenticate with a given Azure Active Directory tenant, you call `create_azure_login()` and supply your credentials. AzureRMR will prompt you for permission to create a special data directory in which to cache the obtained authentication token and Resource Manager login. Once this information is saved on your machine, it can be retrieved in subsequent R sessions with `get_azure_login()`. Your credentials will be automatically refreshed so you don't have to reauthenticate.
+Under the hood, AzureRMR uses a similar authentication process to the [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/?view=azure-cli-latest). The first time you authenticate with a given Azure Active Directory tenant, you call `create_azure_login()` and supply your credentials. AzureRMR will prompt you for permission to create a special data directory in which to cache the obtained authentication token and Resource Manager login. Once this information is saved on your machine, it can be retrieved in subsequent R sessions with `get_azure_login()`. Your credentials will be automatically refreshed so you don't have to reauthenticate.
 
 Unless you have a specific reason otherwise, it's recommended that you allow AzureRMR to create this caching directory. Note that many other cloud engineering tools save credentials in this way, including the Azure CLI itself.