# Restart Azure VM

### Description

The Restart VM action is designed to restart a specific virtual machine in Azure. By using the context of the current state, this action fetches an Azure access token and issues a restart command to the specified VM. The action ensures that the VM is restarted successfully and provides feedback on the process.

### Display Criteria

By default, this Action is disabled and when enabled will appear for all resources that have resource type `azurerm_virtual_machine`. If you want to display this action only for certain resources, please check [display criteria](#display-criteria).

### Setup

This action requires the following variables as [Workspace Variables](https://docs.terrakube.io/2.21.0/user-guide/variables#workspace-specific-variables) or [Global Variables](https://docs.terrakube.io/2.21.0/user-guide/organizations/global-variables) in the Workspace Organization:

* `ARM_CLIENT_ID`: The Azure Client ID used for authentication.
* `ARM_CLIENT_SECRET`: The Azure Client Secret used for authentication.
* `ARM_TENANT_ID`: The Azure Tenant ID associated with your subscription.
* `ARM_SUBSCRIPTION_ID`: The Azure Subscription ID where the VM is located.

{% hint style="info" %}
The Client ID should have at least Virtual Machine Contributor access on the VM or resource group.
{% endhint %}

### Usage

* Navigate to the `Workspace Overview` or the `Visual State` and click on a resource name.

<figure><img src="https://3421131615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx1Ja1Osjf4KfhcMlJJom%2Fuploads%2Fgit-blob-49f6e6461608af5dd24670981261715280988e97%2Fimage%20(393).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3421131615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx1Ja1Osjf4KfhcMlJJom%2Fuploads%2Fgit-blob-a2b272541fbfb839191ddeea47bf1b8868ff3541%2Fimage%20(394).png?alt=media" alt=""><figcaption></figcaption></figure>

* In the Resource Drawer, click the "Restart" button.

<figure><img src="https://3421131615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx1Ja1Osjf4KfhcMlJJom%2Fuploads%2Fgit-blob-6c77bb709348eba3e12ca59b4d951341a5b89254%2Fimage%20(18).png?alt=media" alt=""><figcaption></figcaption></figure>

* The VM will be restarted, and a success or error message will be displayed.

<figure><img src="https://3421131615-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx1Ja1Osjf4KfhcMlJJom%2Fuploads%2Fgit-blob-433a29d609c087f87fd7f099920767bc7d1fa09c%2Fimage%20(1)%20(1)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>