---
title: "Restart a Bare Metal Instance."
method: POST
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BareMetalInfrastructure/bareMetalInstances/{azureBareMetalInstanceName}/restart"
tags: ["Bare Metal Instances"]
---

# Restart a Bare Metal Instance.

`POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BareMetalInfrastructure/bareMetalInstances/{azureBareMetalInstanceName}/restart`

The operation to restart an Azure Bare Metal Instance

## Path parameters

- `azureBareMetalInstanceName` string, required

## Parameters

- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/SubscriptionIdParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/ResourceGroupNameParameter` — unresolved $ref

## Request body

- ForceState — The active state empowers the server with the ability to forcefully terminate and halt any existing processes that may be running on the server
  - `forceState` 'active' | 'inactive' — Whether to force restart by shutting all processes.

## Response `200`

OK

- OperationStatus — The OperationStatus object returns the state of an asynchronous operation.
  - `name` string — Unique Operation Status Identifier.
  - `status` 'Requesting' | 'Executing' | 'Succeeded' | 'Failed' — Status of the operation.
  - `startTime` string — Start Time when the operation was initially executed.
  - `error` object — An error from the Azure Bare Metal Infrastructure service.
    - `code` string — Server-defined set of error codes.
    - `message` string — Human-readable representation of the error.

## Other responses

- `202` — Accepted. The response indicates that the existing Bare Metal Instance is now restarting and includes a 'Location' header to query the operation result.
- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/baremetalinfrastructure-microsoft-baremetalinfrastructure-ba.md) · [All operations](https://skmtc.net/azure/apis/baremetalinfrastructure-microsoft-baremetalinfrastructure-ba/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/baremetalinfrastructure-microsoft-baremetalinfrastructure-ba/revisions/6a50fe9066d2/schema)