> For the complete documentation index, see [llms.txt](https://docs.instruqt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.instruqt.com/sandboxes/cloud-accounts/azure-subscriptions/azure-roles.md).

# Azure Roles

The `roles` option allows you to choose one or more Azure built-in roles to grant access to your Azure subscription. See [Azure built-in roles](https://docs.microsoft.com/en-us/azure/role-based-access-control/built-in-roles) that you can apply.

You might start with the role `Virtual Machine Contributor` which gives the learner the ability to spin up and configure Azure virtual machines:

{% tabs %}
{% tab title="🌐 Web UI" %}
Update your Azure subscription by entering the following in the **Assigned Roles** field:

```
Virtual Machine Contributor
```

And clicking **Add**.
{% endtab %}

{% tab title="💻 Instruqt CLI" %}
Edit your `config.yml` file to include this content:

```
azure_subscriptions:
- name: azuresubscription
  roles:
  - Virtual Machine Contributor
```

{% endtab %}
{% endtabs %}