API de sistemas operativos

Listar todos os sistemas operativos

Obtén unha lista de todos os sistemas operativos dispoñíbeis que se poden instalar nos servidores VPS.

Parámetros de consulta

Exemplo de solicitude

curl -X GET "https://admin.vps.org/api/v1/operating-systems/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

url = "https://admin.vps.org/api/v1/operating-systems/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch('https://admin.vps.org/api/v1/operating-systems/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const os = await response.json();
console.log(os);

$ch = curl_init('https://admin.vps.org/api/v1/operating-systems/');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$operating_systems = json_decode($response, true);
curl_close($ch);

Exemplo de resposta

{
  "count": 12,
  "results": [
    {
      "id": 1,
      "name": "Ubuntu 22.04 LTS",
      "slug": "ubuntu-22-04",
      "version": "22.04",
      "os_type": "linux",
      "distribution": "Ubuntu",
      "architecture": "x86_64",
      "featured": true,
      "available": true,
      "min_disk_gb": 10,
      "description": "Ubuntu 22.04 LTS (Jammy Jellyfish) - Long Term Support until 2027",
      "icon_url": "https://cdn.vps.org/os-icons/ubuntu.svg"
    },
    {
      "id": 2,
      "name": "Debian 12",
      "slug": "debian-12",
      "version": "12",
      "os_type": "linux",
      "distribution": "Debian",
      "architecture": "x86_64",
      "featured": true,
      "available": true,
      "min_disk_gb": 10,
      "description": "Debian 12 (Bookworm) - Stable release",
      "icon_url": "https://cdn.vps.org/os-icons/debian.svg"
    },
    {
      "id": 3,
      "name": "CentOS Stream 9",
      "slug": "centos-stream-9",
      "version": "9",
      "os_type": "linux",
      "distribution": "CentOS",
      "architecture": "x86_64",
      "featured": false,
      "available": true,
      "min_disk_gb": 10,
      "description": "CentOS Stream 9 - Rolling release tracking RHEL development",
      "icon_url": "https://cdn.vps.org/os-icons/centos.svg"
    },
    {
      "id": 4,
      "name": "Fedora 39",
      "slug": "fedora-39",
      "version": "39",
      "os_type": "linux",
      "distribution": "Fedora",
      "architecture": "x86_64",
      "featured": false,
      "available": true,
      "min_disk_gb": 15,
      "description": "Fedora 39 - Cutting-edge Linux distribution",
      "icon_url": "https://cdn.vps.org/os-icons/fedora.svg"
    },
    {
      "id": 5,
      "name": "Rocky Linux 9",
      "slug": "rocky-linux-9",
      "version": "9",
      "os_type": "linux",
      "distribution": "Rocky Linux",
      "architecture": "x86_64",
      "featured": true,
      "available": true,
      "min_disk_gb": 10,
      "description": "Rocky Linux 9 - Enterprise-grade Linux, RHEL compatible",
      "icon_url": "https://cdn.vps.org/os-icons/rocky.svg"
    }
  ]
}

Campos de resposta

Códigos de estado de resposta

Obter os detalles do sistema operativo

Obteña información detallada acerca dun sistema operativo específico.

Parámetros da ruta

Exemplo de solicitude

curl -X GET "https://admin.vps.org/api/v1/operating-systems/1/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

os_id = 1
url = f"https://admin.vps.org/api/v1/operating-systems/{os_id}/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const osId = 1;
const response = await fetch(`https://admin.vps.org/api/v1/operating-systems/${osId}/`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const os = await response.json();
console.log(os);

Exemplo de resposta

{
  "id": 1,
  "name": "Ubuntu 22.04 LTS",
  "slug": "ubuntu-22-04",
  "version": "22.04",
  "os_type": "linux",
  "distribution": "Ubuntu",
  "architecture": "x86_64",
  "featured": true,
  "available": true,
  "min_disk_gb": 10,
  "description": "Ubuntu 22.04 LTS (Jammy Jellyfish) - Long Term Support until 2027",
  "icon_url": "https://cdn.vps.org/os-icons/ubuntu.svg",
  "release_date": "2022-04-21",
  "support_end_date": "2027-04-21",
  "default_user": "root",
  "package_manager": "apt",
  "init_system": "systemd",
  "kernel_version": "5.15",
  "features": [
    "Long Term Support (LTS) until 2027",
    "5 years of free security updates",
    "Extended Security Maintenance available",
    "Large community support",
    "Extensive package repository",
    "Cloud-optimized kernel",
    "Regular point releases"
  ],
  "recommended_for": [
    "Web servers (Apache, Nginx)",
    "Application servers",
    "Database servers (MySQL, PostgreSQL)",
    "Docker containers",
    "Kubernetes nodes",
    "Development environments",
    "Production workloads"
  ],
  "installation_notes": [
    "Requires minimum 10GB disk space",
    "SSH enabled by default on port 22",
    "UFW firewall available but not enabled by default",
    "Automatic security updates can be configured",
    "Cloud-init supported for automated setup"
  ]
}

Códigos de estado de resposta

Featured Operating Systems

VPS.org recomenda os seguintes sistemas operativos para a maioría dos casos de uso:

Escoller o sistema operativo correcto

Segundo o caso de uso

Segundo o nivel de experiencia

• Principiantes: Ubuntu 22.04 LTS - A maioría da documentación e titoriais dispoñibles
• Intermedio: Debian 12 - Gran equilibrio entre estabilidade e funcionalidades
• Avanzado/ Empresarial: Rocky Linux 9, AlmaLinux 9 - Características empresariais e soporte prolongado
• Desenvolventes: Fedora 39 - As últimas características e software de vangarda

Instalación e configuración

Que ocorre durante a instalación do SO

1. Selección de imaxe: O modelo do SO escollido do noso repositorio
2. Particionamento do disco: Particionamento automático baseado no tamaño do plano
3. Instalación base: Instalación dos paquetes do sistema operativo principal (5- 10 minutos)
4. Configuración da rede: Configurouse o enderezo IP, DNS e pasarelaName
5. Configuración de SSH: Servidor SSH habilitado no porto 22
6. Acceso de root: O contrasinal de root enviouse por correo electrónico
7. Cloud- Init: Aplicada a configuración inicial (se está soportada)

Pasos posteriores á instalación

• Sistema de actualización: Executar as actualizacións do sistema inmediatamente despois da instalación
• Configurar o cortafuegos: Configure UFW (Ubuntu/Debian) ou firewalld (baseado en RHEL)
• Crear usuarios: Engadir contas de usuario non root con acceso sudo
• Chaves SSH: Configurar a autenticación con chave SSH e desactivar a autenticación con contrasinal
• Actualizacións de seguridade: Activar as actualizacións automáticas de seguridade
• Vixilancia: Instalar ferramentas de vixilancia (opcional)

Credenciais predeterminadas

Soporte e documentación

Para guías de configuración específicas do sistema operativo, visite a nosa centro de documentación:

• Ubuntu Initial Server Setup
• Debian Security Hardening
• CentOS/Rocky Linux Firewall Setup