AzureRMR (version 1.0.0)

az_rm: Azure Resource Manager

Description

Base class for interacting with Azure Resource Manager.

Usage

az_rm

Format

An R6 object of class az_rm.

Methods

• new(tenant, app, ...): Initialize a new ARM connection with the given credentials. See 'Authentication` for more details.

• list_subscriptions(): Returns a list of objects, one for each subscription associated with this app ID.

• get_subscription(id): Returns an object representing a subscription.

Authentication

To authenticate with ARM, provide the following arguments to the new method:

• tenant: Your tenant ID.

• app: Your client/app ID which you registered in Azure Active Directory.

• auth_type: Either "client_credentials" (the default) or "device_code".

• password: if auth_type == "client_credentials", your password.

• host: your ARM host. Defaults to https://management.azure.com/. Change this if you are using a government or private cloud.

• aad_host: Azure Active Directory host for authentication. Defaults to https://login.microsoftonline.com/. Change this if you are using a government or private cloud.

• config_file: Optionally, a JSON file containing any of the arguments listed above. Arguments supplied in this file take priority over those supplied on the command line. You can also use the output from the Azure CLI az ad sp create-for-rbac command.

• token: Optionally, an OAuth 2.0 token, of class AzureToken. This allows you to reuse the authentication details for an existing session. If supplied, all other arguments will be ignored.

See Also

get_azure_token, AzureToken, Azure Resource Manager overview, REST API reference

Examples

# NOT RUN {
# start a new Resource Manager session
az <- az_rm$new(tenant="myaadtenant.onmicrosoft.com", app="app_id", password="password")

# authenticate with credentials in a file
az <- az_rm$new(config_file="creds.json")

# authenticate with device code
az <- az_rm$new(tenant="myaadtenant.onmicrosoft.com", app="app_id", auth_type="device_code")

# retrieve a list of subscription objects
az$list_subscriptions()

# a specific subscription
az$get_subscription("subscription_id")

# }