GET /api/v1/machines/{id}
Retrieve a specific machine by ID
Retrieve a specific machine by ID.
Sequence Diagram
sequenceDiagram
participant Client as Admin Client
participant API as Machine Service
participant DB as Firestore
Client->>API: GET /api/v1/machines/{id}
API->>DB: Query machine by ID
DB-->>API: Machine profile
API-->>Client: 200 OK (machine profile)Request
Path Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Machine identifier (UUIDv7 format) |
Example Request:
GET /api/v1/machines/018c7dbd-c000-7000-8000-fedcba987654 HTTP/1.1
Host: machine.example.com
Response
Response (200 OK):
{
"id": "018c7dbd-c000-7000-8000-fedcba987654",
"cpus": [
{
"manufacturer": "Intel",
"clock_frequency": 2400000000,
"cores": 8
}
],
"memory_modules": [
{
"size": 17179869184
},
{
"size": 17179869184
}
],
"accelerators": [],
"nics": [
{
"mac": "52:54:00:12:34:56"
}
],
"drives": [
{
"capacity": 500107862016
}
]
}
Error Responses:
All error responses follow RFC 7807 Problem Details format (see ADR-0007) with Content-Type: application/problem+json.
404 Not Found - Machine with specified ID not found:
{
"type": "https://api.example.com/errors/machine-not-found",
"title": "Machine Not Found",
"status": 404,
"detail": "Machine with ID 018c7dbd-c000-7000-8000-fedcba987654 not found",
"instance": "/api/v1/machines/018c7dbd-c000-7000-8000-fedcba987654",
"machine_id": "018c7dbd-c000-7000-8000-fedcba987654"
}