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

# Shutdown a Bare Metal Instance.

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

The operation to shutdown 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

## 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 turning off 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)