---
title: "Bulut sunucu oluşturma"
description: "İstanbul ya da Avrupa'da sunucu için fiyat alın, sipariş verin ve hazır olmasını bekleyin; asla iki kez sipariş vermeden."
url: https://www.gyrohosting.com/developers/tr/howto/create-server.html
language: tr
openapi: https://www.gyrohosting.com/developers/openapi.json
api_version: 2.30.0
---

# Bulut sunucu oluşturma

İstanbul ya da Avrupa'da sunucu için fiyat alın, sipariş verin ve hazır olmasını bekleyin; asla iki kez sipariş vermeden.

`cloud_order` kapsamlı bir API anahtarı ve yeterli hesap bakiyesi gerekir. Her sipariş bakiyeden ödenir, kayıtlı karttan asla çekilmez.


## 1. Fiyat alın (hiçbir şey oluşturulmaz)

**curl**

```bash
curl -s -X POST https://www.gyrohosting.com/api/v1/client/cloud/servers \
  -H "Authorization: Bearer $GYRO_TOKEN" -H "Content-Type: application/json" \
  -d '{"plan":"standart-2-4","region":"tr-ist-1","image":"ubuntu-24.04","hostname":"web-1","dry_run":true}'
```

**CLI**

```bash
gyro server create web-1 --plan standart-2-4 --region tr-ist-1 --image ubuntu-24.04 --dry-run
```


## 2. confirm + Idempotency-Key ile sipariş verin

**curl**

```bash
curl -s -X POST https://www.gyrohosting.com/api/v1/client/cloud/servers \
  -H "Authorization: Bearer $GYRO_TOKEN" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"plan":"standart-2-4","region":"tr-ist-1","image":"ubuntu-24.04","hostname":"web-1","ssh_keys":[12],"confirm":true}'
```

**CLI**

```bash
gyro server create web-1 --plan standart-2-4 --region tr-ist-1 --image ubuntu-24.04 --ssh-key ~/.ssh/id_ed25519.pub --wait
```

**Terraform**

```hcl
resource "gyro_server" "web" {
  plan          = "standart-2-4"
  region        = "tr-ist-1"
  image         = "ubuntu-24.04"
  hostname      = "web-1"
  ssh_key_ids   = [12]
  confirm_order = true   # sunucu oluşturmak hesap bakiyesinden ödeme yapar
}
```

Ağ hatası mı aldınız? Aynı isteği **aynı** Idempotency-Key ile tekrar gönderin: ilk yanıtı geri alırsınız, ikinci sunucu asla açılmaz.


## 3. Çalışana kadar bekleyin

**curl**

```bash
curl -s https://www.gyrohosting.com/api/v1/client/cloud/servers/12345 -H "Authorization: Bearer $GYRO_TOKEN"
# data.status = "active" ve data.live.power_state = "running" olunca hazır; 5-10 sn arayla sorgulayın
```

**CLI**

```bash
gyro server get 12345 -o json --query 'live.power_state'
```

Paketler: `GET /cloud/products` (`gyro plan list`). Bölgeler: `GET /cloud/locations`. İmajlar: `GET /cloud/images`. Tek siparişte birden çok sunucu: `"quantity": 3` (`--count 3`).