NEWS

---

AzureRMR 2.4.4 (2023-09-21)

• Fix broken list_azure_logins function. Thanks to Pedro Z (@pedrobtz).
• Add a get_tags method for subscription objects. Thanks to Bert Neef (@bertneef).

AzureRMR 2.4.3 (2021-10-23)

• Some tweaks to the logic for retrieving ARM login objects. Like with AzureGraph::get_graph_login, get_azure_login now has app, scopes and auth_type arguments to let you specify a particular login to retrieve.

AzureRMR 2.4.2 (2021-06-03)

• Replace the old "Service principal" vignette with an "Authentication basics" vignette, which provides more information on common authentication flows.
• Update Resource Manager API version to "2021-04-01".
  • Also update az_subscription$list_locations to handle the new response format.

AzureRMR 2.4.1 (2021-02-17)

• Fix the set_tags method to work when called inside a function (#18).
• get_resource(*, api_version=NULL) when there are no stable API versions will now warn and use the latest preview version, rather than throw an error (#19).

AzureRMR 2.4.0 (2021-01-15)

• Some utility functions moved to AzureGraph package. These are imported and then reexported by AzureRMR so that existing code should work unchanged.
• Add methods to get, create and delete sub-resources of a resource, eg res$get_subresource(type="subrestype", name="subresname"). See az_resource for more information.
• Fix a bug in obtaining the Microsoft Graph login when using AAD v2.0.
• Switch to AAD v2.0 as the default for authenticating.

AzureRMR 2.3.6 (2020-10-14)

• Add ability to specify user-defined functions in build_template_definition. Also allow changing the schema, content version and api profile.
• Change maintainer email address.

AzureRMR 2.3.5 (2020-07-26)

• Fix a bug in printing the error message when a template deployment fails.
• Use HTTPS for the template schema URL, if not otherwise provided by the user.

AzureRMR 2.3.4 (2020-06-10)

• Add filtering arguments (filter, expand and top) for the list_resource_groups, list_templates and list_resources methods, to trim the results. See the Azure docs for more details.
• Add createdBy:AzureR/AzureRMR tag to Azure objects (resource groups, resources and templates) created by this package.
• Add a get_tags() method for templates.

AzureRMR 2.3.3 (2020-05-15)

• Allow for extra resource type-specific fields beyond those mentioned in the Resource Manager documentation. In particular, virtual machines and managed disks may have a zones field containing the availability zones.

AzureRMR 2.3.2 (2020-04-23)

• Add do_operation method for the Resource Manager login client, allowing arbitrary operations at the top-level scope.

AzureRMR 2.3.1 (2020-01-27)

• Update Resource Manager API version to "2019-10-01".
• Export get_paged_list utility function.

AzureRMR 2.3.0 (2019-10-31)

• New in this version is a facility for parallelising connections to Azure, using a pool of background processes. Some operations, such as downloading many small files or interacting with a cluster of VMs, can be sped up significantly by carrying them out in parallel rather than sequentially. The code for this is currently duplicated in multiple packages including AzureStor and AzureVM; putting it in AzureRMR removes the duplication and also makes it available to other packages that may benefit. See ?pool for more details.
• Expose do_operation methods for subscription and resource group objects, similar to that for resources. This allows arbitrary operations on a sub or RG.
• AzureRMR now directly imports AzureGraph.
• Update default Resource Manager API version to "2019-08-01".
• Provide more informative error messages, especially when a template deployment fails.

AzureRMR 2.2.0 (2019-09-17)

• If the AzureGraph package is installed, create_azure_login can now create a login client for Microsoft Graph with the same credentials as the ARM client. This is to facilitate working with registered apps and service principals, eg when managing roles and permissions. Some Azure services also require creating service principals as part of creating a resource (eg Azure Kubernetes Service), and keeping the Graph credentials consistent with ARM helps ensure nothing breaks.
• Fix a bug where create_azure_login still required the tenant argument when a token was supplied.
• Fixes to allow use of Azure Active Directory v2.0 tokens for authenticating. Note that AAD v1.0 is still the default and recommended version.
• Use utils::askYesNo for confirmation prompts on R >= 3.5, eg when deleting resources; this fixes a bug in reading the input. As a side-effect, Windows users who are using RGUI.exe will see a popup dialog box instead of a message in the terminal.

AzureRMR 2.1.3 (2019-07-18)

• Fix a bug where failure to create a resource would not be detected.
• Make setting tags more robust (some resources return a null tags field when no tags are present, rather than an empty object).
• Better handling of null fields for all REST calls.

AzureRMR 2.1.2 (2019-06-04)

• Fix a bug in template deployment where null fields were not handled correctly.
• New build_template_definition and build_parameters_parameters generics to help in template deployment. These can take as inputs R lists, JSON text strings, or file connections, and can also be extended by other packages.

AzureRMR 2.1.1 (2019-05-12)

• Some refactoring of login code to better handle AzureAuth options. As part of this, the config_file argument for az_rm$new has been removed; to use a configuration file, call the (recommended) create_azure_login function.
• az_subscription$get_provider_api_version now returns only stable APIs by default. Set the argument stable_only=FALSE to allow returning preview APIs.

AzureRMR 2.1.0 (2019-04-02)

• This version adds basic support for role-based access control (RBAC) at subscription, resource group and resource level. Add and remove role assignments, and retrieve role definitions. See ?rbac for more information.
• Fix a bug where if the user decides not to create a caching dir when prompted by AzureAuth, AzureRMR would pop up a second prompt.
• Internal refactoring to remove duplicated code.

AzureRMR 2.0.0 (2019-02-25)

Significant interface changes

• New create_azure_login, get_azure_login and delete_azure_login functions to handle ARM authentication. By default, these will authenticate using your AAD user credentials without requiring you to create a service principal. Directly calling az_rm$new() will still work, but it's recommended to use create_azure_login and get_azure_login going forward. Login credentials will be saved and reused for subsequent sessions (see below).
• Token acquisition logic substantially enhanced and moved to a new package, AzureAuth. get_azure_token now supports four authentication methods for obtaining tokens (client_credentials, authorization_code, device_code and resource_owner). Tokens are also automatically cached and retrieved for use in subsequent sessions, without needing the user to reauthenticate. See the AzureAuth documentation for more details.

Other changes

• Don't print empty fields for ARM objects.
• Add optional etag field to resource object definition.
• Add location argument to az_resource_group$create_resource method, rather than hardcoding it to the resgroup location.
• Add wait argument when creating a new resource, similar to deploying a template, since some resources will return before provisioning is complete. Defaults to FALSE for backward compatibility.
• Export is_azure_token.
• Allow az_resource_group$deploy_template() to work without parameters arg (parameters folded into template itself).
• Fix a bug that kept az_resource_group$delete_resource from deleting the resource.
• New resource method az_resource$get_api_version to match set_api_version.
• By default, use the latest stable API version when interacting with resources. az_resource$set_api_version gains a new argument stable_only which defaults to TRUE; set this to FALSE if you want the latest preview version.
• az_resource$sync_fields() will respect a non-default API version.
• Add management lock functionality for subscriptions, resource groups and resources. Call create_lock to create a lock, get_lock to retrieve an existing lock object, and delete_lock to delete a lock. Call list_locks to list all the locks that apply to an object.
• Add tagging functionality for resource groups, similar to that for resources. Call set_tags to set tags, and get_tags to retrieve them.
• Allow named_list to accept empty inputs. The output will be a list of length 0 with a names attribute.
• Fix template deployment not to drop empty fields (related to #13).

AzureRMR 1.0.0 (2018-12-02)

• Submitted to CRAN

AzureRMR 0.9.0

• Moved to cloudyr organisation