Neue VM erstellen

PUT /vm/create

Die maximalen Werte für die Ressourcen sind abhängig vom Hostsystem und können im /vm/list/hosts Endpunkt abgerufen werden.

Body Parameter (application/x-www-form-urlencoded)

Name Format Beschreibung Optional
cores Integer (1 - n) Anzahl der virtuellen Kerne —
mem Integer (1024 - n) Arbeitsspeicher in MB —
disk Integer (10 - n) NVMe Speicher in GB —
os Betriebssystem —
hostsystem Hostsystem —
ips Integer (1 - n) Anzahl an IP-Adressen (Standard: 1)
backup_slots Integer (2 - n) Anzahl an Backup-Slots (Standard: 2)
network_speed Integer (1000 - n) Netzwerkgeschwindigkeit in Mbit (Standard: 1000)
hostname String Hostname, kann nachträglich nur noch eigenständig geändert werden (Standard: KVM)
storage Integer (500 - n) Zusätzlicher HDD-Speicher. Nur bei VMs im NTT möglich
ssh_key String SSH-Key (URL-Encoded public_key) für die VM
ssh_key_displayname String Displayname zum hinterlegten SSH-Key
allowFallbackIPs Boolean Bei eigenen IP-Subnetzen: Legt fest, ob als Fallback Standard IPs der FireAPI außerhalb der eigenen Subnetze verwendet werden sollen, sofern keine eigenen IPs mehr verfügbar sind. (Standard: false)
default_ptr String Vollqualifizierter Domainname, der als rDNS-Eintrag initial gesetzt werden soll (Standard: fireapi.de)

Response (application/json)

200 
{4 Eigenschaften
  "status": "success",
  "requestID": "efd58c73-2bf1-4d15-bf2e-689fc82a2a9f",
  "message": "VM successfully created",
  "data": {4 Eigenschaften
    "identifier": 30075,
    "hostsystem": {5 Eigenschaften
      "datacenter": {3 Eigenschaften
        "name": "SkyLink Data Center BV",
        "country": "Niederlande",
        "city": "Eygelshoven"
      },
      "node": "node09",
      "processor": "Intel(R) Xeon(R) CPU E5-2690 v2 @ 3.00GHz",
      "memory": "DDR3 Synchronous Registered (Buffered) 1600 MHz",
      "nvme_hard_drives": "Samsung SSD PM9A3"
    },
    "config": {11 Eigenschaften
      "cores": 1,
      "mem": 1024,
      "disk": 10,
      "os": {2 Eigenschaften
        "name": "debian_11",
        "displayname": "Debian 11"
      },
      "username": "root",
      "password": "c&zp3!VFsrW3",
      "hostname": "KVM",
      "network_speed": "1000",
      "backup_slots": "2",
      "ipv4": [2 Elemente
        {3 Eigenschaften
          "address": "88.151.194.252",
          "gateway": "88.151.194.1",
          "ddos_protection": "combahton"
        },
        {3 Eigenschaften
          "address": "88.151.194.253",
          "gateway": "88.151.194.1",
          "ddos_protection": "combahton"
        }
      ],
      "ipv6": [1 Element
        {2 Eigenschaften
          "ip_address": "2a12:8641:0007:48f5::/64",
          "ip_gateway": "2a12:8641:7::1"
        }
      ]
    },
    "pricings": {1 Eigenschaft
      "monthly": 3.53
    }
  }
}

cURL

curl -X PUT 'https://live.fireapi.de/vm/create' \
  -H 'X-FIRE-APIKEY: YOUR-API-KEY' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'cores=VALUE&mem=VALUE&disk=VALUE&os=VALUE&hostsystem=VALUE&ips=VALUE&backup_slots=VALUE&network_speed=VALUE&hostname=VALUE&storage=VALUE&ssh_key=VALUE&ssh_key_displayname=VALUE&allowFallbackIPs=VALUE&default_ptr=VALUE'