Retrieve system status
GET/system/status
Get the current status of the system including hostname, uptime, load averages, memory, and disk usage.
Responses
- 200
- 401
- 403
- 500
A JSON object containing the system's status information.
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
The hostname of the system.
The uptime of the system.
load_average
object
required
The system load averages for 1, 5, and 15 minutes.
Load average for the last 1 minute.
Load average for the last 5 minutes.
Load average for the last 15 minutes.
memory
object
required
Memory usage information.
Total memory in bytes.
Free memory in bytes.
Used memory in bytes.
disks
object[]
required
List of local disk usage information.
Disk identifier, e.g., "/dev/sda1".
Total disk space in bytes.
Used disk space in bytes.
Free disk space in bytes.
os_info
object
required
Operating system information.
The name of the Linux distribution.
The version of the Linux distribution.
{
"hostname": "my-linux-server",
"uptime": "0 days, 4 hours, 1 minute",
"load_average": {
"1min": 0.32,
"5min": 0.28,
"15min": 0.25
},
"memory": {
"total": 8388608,
"free": 2097152,
"used": 4194304
},
"disks": [
{
"name": "/dev/sda1",
"total": 500000000000,
"used": 250000000000,
"free": 250000000000
}
],
"os_info": {
"distribution": "Ubuntu",
"version": "20.04"
}
}
Unauthorized - API key required
- application/json
- Schema
- Example (from schema)
Schema
A description of the error that occurred.
Additional details about the error.
The error code.
{
"error": "Failed to retrieve status.",
"details": "Failed due to network timeout.",
"code": 500
}
Forbidden - Insufficient permissions
- application/json
- Schema
- Example (from schema)
Schema
A description of the error that occurred.
Additional details about the error.
The error code.
{
"error": "Failed to retrieve status.",
"details": "Failed due to network timeout.",
"code": 500
}
Error retrieving system status.
- application/json
- Schema
- Example (from schema)
Schema
A description of the error that occurred.
Additional details about the error.
The error code.
{
"error": "Failed to retrieve status.",
"details": "Failed due to network timeout.",
"code": 500
}