Disk usage¶

Get server disk usage and total storage space available.

• HTTP Method: GET
• URL: https://example.domain.tld/api/v1/server/disk/usage/
• Require authentication: Yes
• Permission level required: MasterAdmin

Response parameters¶

Parameter	Type	Description
total_storage_gb	float	Total storage space in GiB
usage_gb	float	Usage in GiB
usage_kb	float	Usage in KiB
usage_mb	float	Usage in MiB

Example request (Python)¶

import requests
import json
from pprint import pprint

url = "https://example.domain.tld/api/v1/server/disk/usage/"
r = requests.get(url, auth=("admin","long-auth_token-here"))
try:
    pprint(r.json())
except:
    print(r.text)

Example response (JSON)¶

{'total_storage_gb': 1000.0,
 'usage_gb': 171.72,
 'usage_kb': 180062944.0,
 'usage_mb': 175842.72}