Sunucu Oluşturma

Sunucu Config Bilgisi

Bu endpoint ile bir sunucu oluşturmak için gerekli parametreleri alabilirsiniz. v2'de ek olarak hesabınıza ait network listesi de döner.

Endpoint

GET https://api.ilkbyte.com/v2/server/create

Params

Herhangi bir parametre göndermenize gerek yoktur.

Response

{
  "success": true,
  "message": "Config options",
  "data": {
    "application": [
      {
        "code": 2,
        "name": "Minio",
        "system": "Ubuntu 16.04 LTS"
      }
    ],
    "operating_system": [
      {
        "code": 1,
        "name": "Ubuntu",
        "version": "22.04 LTS"
      }
    ],
    "package": [
      {
        "code": 5,
        "features": "2 vCPU / 2 GB Memory / 20 GB SSD Disk / 1000 GB Bandwidth",
        "name": "Cloud I",
        "price": "$3.49/monthly"
      }
    ],
    "network": [
      {
        "id": 42,
        "name": "my-network",
        "description": "Test ağım",
        "server_count": 3
      }
    ]
  }
}

Sunucu Oluşturma

Bu endpoint ile sunucu oluşturabilirsiniz. network_id gönderilmezse hesabınızdaki ilk network otomatik olarak atanır; hesabınızda hiç network yoksa default adında bir network otomatik oluşturulur. Network yönetimi için Network Yönetimi sayfasına bakınız.

Endpoint

GET https://api.ilkbyte.com/v2/server/create/config

Params

Parametre	Tip	Açıklama	Gereklilik
name	string	Alfanümerik sunucu adı (3-16 karakter)	Zorunlu
network_id	integer	Sunucunun bağlanacağı network ID'si. Gönderilmezse hesabın varsayılan network'ü otomatik atanır	Opsiyonel
os_id	integer	İşletim sistemi ID. Hazır uygulama kurulacaksa 0 olmalı	Zorunlu
app_id	integer	Hazır uygulama ID. İşletim sistemi kurulacaksa 0 olmalı	Zorunlu
package_id	integer	Sunucu paketi ID numarası	Zorunlu
use_public_ip	bool	Sunucuya public IP atanıp atanmayacağı (varsayılan: true)	Opsiyonel
username	string	Sunucu kullanıcı adı (cloud_init kullanılmıyorsa zorunlu)	Opsiyonel
password	string	Sunucu kullanıcı şifresi. Base64 olacak şekilde gönderilmelidir (cloud_init kullanılmıyorsa zorunlu)	Opsiyonel
cloud_init	string	Cloud-init YAML içeriği, Base64 kodlanmış	Opsiyonel
sshkeys[]	string	SSH key ID'si. Birden fazla için aynı parametre tekrarlanabilir	Opsiyonel
custom_ip	string	Rezerve edilmiş belirli bir IP'nin atanması	Opsiyonel
buy_static_ip	bool	Statik IP satın alınarak atanması	Opsiyonel
is_isolated	bool	Sunucunun izole modda oluşturulması	Opsiyonel
pay_credit_card	bool	Hesap bakiyesi yerine kayıtlı karttan ödeme yapılacaksa true	Opsiyonel
credit_card_id	integer	Kullanılacak kayıtlı kart ID'si, buradan ulaşılabilir	Opsiyonel

Response

{
  "success": true,
  "message": "Sunucu oluşturma başlatıldı!",
  "data": {
    "server_info": {
      "name": "Test",
      "ipv4": "127.0.0.1",
      "private_ip": "10.0.0.5",
      "network_id": 42,
      "is_vxlan": true,
      "task_uuid": "abc123-...",
      "status": "InProgress"
    },
    "username": "ilkbyte",
    "password": "********"
  }
}

Not: Sunucu oluşturma işlemi asenkron olarak gerçekleşir. status alanı InProgress döner, sunucu hazır olduğunda Active olur.

Custom Image ile Sunucu Oluşturma

Bu endpoint ile kendi disk imajınızı (ISO/QCOW2) kullanarak sunucu oluşturabilirsiniz. İmaj URL üzerinden indirilir ve SHA256 hash ile doğrulanır. network_id gönderilmezse hesabın varsayılan network'ü otomatik atanır.

Endpoint

POST https://api.ilkbyte.com/v2/server/create/custom-img

Params

Parametre	Tip	Açıklama	Gereklilik
name	string	Alfanümerik sunucu adı (3-16 karakter)	Zorunlu
img_url	string	Disk imajının indirileceği URL	Zorunlu
img_sha256	string	İmajın SHA256 hash değeri (doğrulama için)	Zorunlu
package_id	integer	Sunucu paketi ID numarası	Zorunlu
network_id	integer	Sunucunun bağlanacağı network ID'si. Gönderilmezse hesabın varsayılan network'ü otomatik atanır	Opsiyonel
use_public_ip	bool	VXLAN sunucusuna public IP atanıp atanmayacağı (varsayılan: false)	Opsiyonel
custom_ip	string	Rezerve edilmiş belirli bir IP'nin atanması	Opsiyonel
username	string	Sunucu kullanıcı adı	Opsiyonel
password	string	Sunucu şifresi, Base64 kodlanmış	Opsiyonel
cloud_init	string	Cloud-init YAML içeriği, Base64 kodlanmış	Opsiyonel
sshkeys[]	string	SSH key ID'si. Birden fazla için aynı parametre tekrarlanabilir	Opsiyonel
pay_credit_card	bool	Hesap bakiyesi yerine kayıtlı karttan ödeme yapılacaksa true	Opsiyonel
credit_card_id	integer	Kullanılacak kayıtlı kart ID'si, buradan ulaşılabilir	Opsiyonel

Response

{
  "success": true,
  "message": "Server start to create with custom image!",
  "data": {
    "server_info": {
      "name": "myserver",
      "ipv4": "127.0.0.1",
      "ipv6": "",
      "private_ip": "10.0.0.5",
      "network_id": 42,
      "task_uuid": "abc123-...",
      "status": "InProgress"
    }
  }
}

Not: Sunucu oluşturma işlemi asenkron olarak gerçekleşir. status alanı InProgress döner, sunucu hazır olduğunda Active olur.