> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mountthor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Bare Metal Machine

> Returns one bare-metal machine by name, including desired state and customer-visible status.



## OpenAPI

````yaml /api-reference/customer-api.v1.openapi.json get /v1/compute/apis/compute.mountthor.com/v1alpha1/namespaces/{namespace}/baremetalmachines/{name}
openapi: 3.1.0
info:
  title: Mount Thor Customer API
  version: v1
servers:
  - description: Mount Thor customer API edge
    url: https://api.mountthor.com
security: []
paths:
  /v1/compute/apis/compute.mountthor.com/v1alpha1/namespaces/{namespace}/baremetalmachines/{name}:
    get:
      tags:
        - compute
      summary: Get Bare Metal Machine
      description: >-
        Returns one bare-metal machine by name, including desired state and
        customer-visible status.
      operationId: getBareMetalMachine
      parameters:
        - description: Tenant namespace returned by Get Account.
          in: path
          name: namespace
          required: true
          schema:
            type: string
        - description: Kubernetes object name for the BareMetalMachine.
          in: path
          name: name
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BareMetalMachineV1ALPHA1'
          description: Resource returned
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KubernetesStatus'
          description: Invalid request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KubernetesStatus'
          description: Authentication required
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KubernetesStatus'
          description: Permission denied
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KubernetesStatus'
          description: Resource not found
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KubernetesStatus'
          description: Conflict
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KubernetesStatus'
          description: Validation failed
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KubernetesStatus'
          description: Rate limit exceeded
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KubernetesStatus'
          description: Request failed
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KubernetesStatus'
          description: Service unavailable
        '504':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KubernetesStatus'
          description: Request timed out
      security:
        - MountThorSession:
            - compute:read
components:
  schemas:
    BareMetalMachineV1ALPHA1:
      additionalProperties: false
      description: >-
        Customer-owned bare-metal Mac allocation managed through the Compute
        API.
      properties:
        apiVersion:
          description: Kubernetes API version. Must be `compute.mountthor.com/v1alpha1`.
          enum:
            - compute.mountthor.com/v1alpha1
          type: string
        kind:
          description: Kubernetes resource kind. Must be `BareMetalMachine`.
          enum:
            - BareMetalMachine
          type: string
        metadata:
          additionalProperties: false
          description: Customer-safe metadata for the BareMetalMachine.
          properties:
            annotations:
              additionalProperties:
                type: string
              type: object
            creationTimestamp:
              format: date-time
              type: string
            deletionTimestamp:
              format: date-time
              nullable: true
              type: string
            generation:
              format: int64
              minimum: 0
              type: integer
            labels:
              additionalProperties:
                type: string
              type: object
            name:
              description: Resource name.
              maxLength: 253
              minLength: 1
              pattern: ^[a-z0-9]([-a-z0-9.]*[a-z0-9])?$
              type: string
            namespace:
              description: Namespace bound to the compute session.
              type: string
            resourceVersion:
              description: Kubernetes resource version.
              type: string
            uid:
              description: Immutable resource identifier.
              type: string
          required:
            - name
          type: object
        spec:
          additionalProperties: false
          description: >-
            BareMetalMachine spec is immutable. Delete and recreate the resource
            to change it.
          properties:
            class:
              type: string
            image:
              type: string
            region:
              type: string
          required:
            - class
          type: object
        status:
          additionalProperties: false
          description: >-
            Observed Mount Thor status for the BareMetalMachine. Customers read
            status; create and update requests should not set it.
          properties:
            capacitySource:
              type: string
            failureCode:
              description: Stable customer-safe failure code.
              enum:
                - InvalidSpec
                - ImageUnavailable
                - ClassUnavailable
                - ReservedCapacityUnavailable
                - CapacityTemporarilyUnavailable
                - AccessNotReady
                - CleanupBlocked
                - InternalError
                - NoCapacityAvailable
                - AllocationBrokerUnavailable
                - PlacementUnavailable
                - HostIneligible
                - ProviderError
                - VMNotFound
              type: string
            failureMessage:
              description: Failure detail.
              type: string
            observedGeneration:
              format: int64
              type: integer
            phase:
              description: >-
                Ready is successful. Failed is terminal. Other phases are in
                progress.
              enum:
                - Pending
                - Allocating
                - Preparing
                - Ready
                - Reclaiming
                - Failed
              type: string
            readyForAccess:
              description: Customer access gate.
              type: boolean
          type: object
      required:
        - spec
        - apiVersion
        - kind
        - metadata
      type: object
    KubernetesStatus:
      additionalProperties: false
      description: Kubernetes API operation result.
      properties:
        apiVersion:
          enum:
            - v1
          type: string
        code:
          format: int32
          maximum: 599
          minimum: 100
          type: integer
        kind:
          enum:
            - Status
          type: string
        message:
          type: string
        reason:
          type: string
        status:
          enum:
            - Success
            - Failure
          type: string
      required:
        - apiVersion
        - kind
        - status
      type: object
  securitySchemes:
    MountThorSession:
      bearerFormat: mt_session
      scheme: bearer
      type: http

````