Kesin kotalı SFTP yedekleme alanı: hesabınızdaki BİR sunucuya bağlıdır ve yalnız o sunucunun IPv4 adreslerinden erişilir (tr-ist-1). Sipariş, bağlantı bilgisi, parola sıfırlama, başka sunucuya bağlama, iptal. Boyut değişimi genel paket değişikliği uçlarıyla yapılır.
Sipariş edilebilir boyutlar (50 GB - 1 TB), dönem başına fiyat (sabit EUR, KDV hariç; list_amount = üstü çizili liste fiyatı) ve servers: alanın bağlanabileceği hesap sunucuları. plans boşsa bu hesap henüz sipariş veremez. available: false = şu an kapasite yok.
Yanıtlar
200
OK — data: object
403
Key lacks the scope, IP not allowed, or feature disabled
404
Not found — also returned for objects owned by someone else
# kaynak gyro_backup_space: https://registry.terraform.io/providers/gyro-hosting/gyro/latest/docs/resources/backup_space
# 100 GB SFTP backup space bound to a server of the account, billed monthly from the balance.
# Only the server's IPv4 addresses can connect (sftp -P 2201 <user>@<host>, write into /veri).
resource "gyro_backup_space" "yedek" {
plan = "100gb"
cycle = "monthly"
server_id = 12345
name = "gyro-proje-yedek"
# destroy deletes the space and every file in it (cannot be undone)
lifecycle {
prevent_destroy = true
}
}
output "sftp" {
value = "sftp -P ${gyro_backup_space.yedek.port} ${gyro_backup_space.yedek.user}@${gyro_backup_space.yedek.host}"
}
# password is sensitive: pass it to a secret store / configuration, never print it
# gyro_backup_space.yedek.password
import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/cloud/backup-spaces", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])
const res = await fetch("https://www.gyrohosting.com/api/v1/client/cloud/backup-spaces", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
},
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);
TEK bir yedekleme alanı sipariş eder ve hesap bakiyesinden öder (kayıtlı kart asla). Alan server_id ile hesabınızdaki etkin bir sunucuya bağlanır (Gyro Bulut tr-ist-1, TR VDS, yönetilen ya da fiziksel); hesapta tek sunucu varsa gönderilmeyebilir. Yalnız o sunucunun IPv4 adresleri bağlanabilir (SFTP, port 2201). cycle dönemine göre ücretlendirilir (sabit EUR fiyat hesap para biriminde, KDV hariç) ve diğer hizmetler gibi bakiyeden yenilenir. Teklif için "dry_run": true; gerçek sipariş "confirm": true ve Idempotency-Key başlığı ister. Alan yaklaşık bir dakikada kurulur (backup_space.statepending -> active); parola GET /cloud/backup-spaces/{id}/credentials ile alınır. Hatalar: 402 insufficient_balance; 403 not_available (bu hesap için satışta değil), orders_disabled; 409 server_required (etkin sunucu yok), capacity_unavailable; 422 confirm_required (quote ile), product_not_orderable, cycle_invalid, server_id_required, invalid_server, invalid_quantity; 429 daily_limit.
Parametreler
Alan
in
Tür
Açıklama
Idempotency-Keyzorunlu
header
string
Unique per logical request (e.g. a UUID). Replays within 24 hours return the stored answer.
İstek gövdesi
Alan
Tür
Açıklama
plan
string
plan from GET /cloud/backup-spaces/plans (50gb, 100gb, 250gb, 500gb, 1tb)
# kaynak gyro_backup_space: https://registry.terraform.io/providers/gyro-hosting/gyro/latest/docs/resources/backup_space
# 100 GB SFTP backup space bound to a server of the account, billed monthly from the balance.
# Only the server's IPv4 addresses can connect (sftp -P 2201 <user>@<host>, write into /veri).
resource "gyro_backup_space" "yedek" {
plan = "100gb"
cycle = "monthly"
server_id = 12345
name = "gyro-proje-yedek"
# destroy deletes the space and every file in it (cannot be undone)
lifecycle {
prevent_destroy = true
}
}
output "sftp" {
value = "sftp -P ${gyro_backup_space.yedek.port} ${gyro_backup_space.yedek.user}@${gyro_backup_space.yedek.host}"
}
# password is sensitive: pass it to a secret store / configuration, never print it
# gyro_backup_space.yedek.password
Hizmet satırı ve backup_space: SFTP adresi, port, kullanıcı, yazılabilir dizin, boyut, kullanım, bağlı sunucu, izinli IP'ler ve durum. Parola yoktur (/credentials).
Parametreler
Alan
in
Tür
Açıklama
idzorunlu
path
integer
Backup space (service) id
Yanıtlar
200
OK — data: object
403
Key lacks the scope, IP not allowed, or feature disabled
404
Not found — also returned for objects owned by someone else
# kaynak gyro_backup_space: https://registry.terraform.io/providers/gyro-hosting/gyro/latest/docs/resources/backup_space
# 100 GB SFTP backup space bound to a server of the account, billed monthly from the balance.
# Only the server's IPv4 addresses can connect (sftp -P 2201 <user>@<host>, write into /veri).
resource "gyro_backup_space" "yedek" {
plan = "100gb"
cycle = "monthly"
server_id = 12345
name = "gyro-proje-yedek"
# destroy deletes the space and every file in it (cannot be undone)
lifecycle {
prevent_destroy = true
}
}
output "sftp" {
value = "sftp -P ${gyro_backup_space.yedek.port} ${gyro_backup_space.yedek.user}@${gyro_backup_space.yedek.host}"
}
# password is sensitive: pass it to a secret store / configuration, never print it
# gyro_backup_space.yedek.password
import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/cloud/backup-spaces/12345", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])
const res = await fetch("https://www.gyrohosting.com/api/v1/client/cloud/backup-spaces/12345", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
},
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);
confirm=true zorunlu. immediate=true hemen iptal eder: SFTP erişimi durur ve alan İÇİNDEKİ TÜM DOSYALARLA yaklaşık bir dakikada kalıcı olarak silinir (snapshot yok, bekleme süresi yok; geri alınamaz). immediate olmadan iptal talebi açılır, işlenene kadar alan çalışır. Anında silme operatörce kapatıldıysa 403 immediate_disabled.
Parametreler
Alan
in
Tür
Açıklama
idzorunlu
path
integer
Backup space (service) id
confirmzorunlu
query
boolean
immediate
query
boolean
delete the space and every file now (cannot be undone)
Yanıtlar
202
OK — data: object
403
Key lacks the scope, IP not allowed, or feature disabled
404
Not found — also returned for objects owned by someone else
422
Validation or business rule failure (confirm_required, invalid_image, tool_action_failed ...)
# kaynak gyro_backup_space: https://registry.terraform.io/providers/gyro-hosting/gyro/latest/docs/resources/backup_space
# 100 GB SFTP backup space bound to a server of the account, billed monthly from the balance.
# Only the server's IPv4 addresses can connect (sftp -P 2201 <user>@<host>, write into /veri).
resource "gyro_backup_space" "yedek" {
plan = "100gb"
cycle = "monthly"
server_id = 12345
name = "gyro-proje-yedek"
# destroy deletes the space and every file in it (cannot be undone)
lifecycle {
prevent_destroy = true
}
}
output "sftp" {
value = "sftp -P ${gyro_backup_space.yedek.port} ${gyro_backup_space.yedek.user}@${gyro_backup_space.yedek.host}"
}
# password is sensitive: pass it to a secret store / configuration, never print it
# gyro_backup_space.yedek.password
import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.delete("https://www.gyrohosting.com/api/v1/client/cloud/backup-spaces/12345", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])
const res = await fetch("https://www.gyrohosting.com/api/v1/client/cloud/backup-spaces/12345", {
method: "DELETE",
headers: {
"Authorization": `Bearer ${process.env.GYRO_TOKEN}`,
},
});
const { data, error } = await res.json();
if (!res.ok) throw new Error(`${error.code}: ${error.message}`);
Parolayla SFTP bağlantı bilgisiKapsam: services_writegetBackupSpaceCredentialsBu işlemin OpenAPI parçası
Adres, port, kullanıcı, dizin ve SFTP parolası (Cache-Control: no-store). Gizli değer gösterdiği için services_write ister. Alan kurulurken 409 not_ready.
Parametreler
Alan
in
Tür
Açıklama
idzorunlu
path
integer
Backup space (service) id
Yanıtlar
200
OK — data: BackupSpaceCredentials
403
Key lacks the scope, IP not allowed, or feature disabled
404
Not found — also returned for objects owned by someone else
409
State conflict (server_locked, not_actionable, ssh_key_exists, server_limit, idempotency_in_flight)
Yeni rastgele parola üretir ve bir kez döndürür. Eski parola hemen geçersiz olur, açık SFTP oturumları kapanır; yedek işlerinizi güncelleyin. "confirm": true zorunlu. Alan etkin değilse 409 not_actionable; 502 backend_unavailable = birkaç dakika sonra yeniden deneyin.
Parametreler
Alan
in
Tür
Açıklama
idzorunlu
path
integer
Backup space (service) id
İstek gövdesi
Alan
Tür
Açıklama
confirmzorunlu
boolean (True)
Yanıtlar
200
OK — data: BackupSpaceCredentials
403
Key lacks the scope, IP not allowed, or feature disabled
404
Not found — also returned for objects owned by someone else
409
State conflict (server_locked, not_actionable, ssh_key_exists, server_limit, idempotency_in_flight)
422
Validation or business rule failure (confirm_required, invalid_image, tool_action_failed ...)
Alanı server_id sunucusuna bağlar (hesabınızdaki etkin sunuculardan biri; tek sunucu varsa isteğe bağlı). Bundan sonra yalnız o sunucunun IPv4 adresleri bağlanabilir; önceki sunucunun erişimi hemen kapanır. Dosyalara dokunulmaz. Bağlı sunucunun IP'si değişir ya da sunucu iptal edilirse erişim kendiliğinden eşitlenir.
Parametreler
Alan
in
Tür
Açıklama
idzorunlu
path
integer
Backup space (service) id
İstek gövdesi
Alan
Tür
Açıklama
server_id
integer
server id
Yanıtlar
200
OK — data: object
403
Key lacks the scope, IP not allowed, or feature disabled
404
Not found — also returned for objects owned by someone else
409
State conflict (server_locked, not_actionable, ssh_key_exists, server_limit, idempotency_in_flight)
422
Validation or business rule failure (confirm_required, invalid_image, tool_action_failed ...)
gyro backup-space attach-server 12345 --help # tüm seçenekler
# kaynak gyro_backup_space: https://registry.terraform.io/providers/gyro-hosting/gyro/latest/docs/resources/backup_space
# 100 GB SFTP backup space bound to a server of the account, billed monthly from the balance.
# Only the server's IPv4 addresses can connect (sftp -P 2201 <user>@<host>, write into /veri).
resource "gyro_backup_space" "yedek" {
plan = "100gb"
cycle = "monthly"
server_id = 12345
name = "gyro-proje-yedek"
# destroy deletes the space and every file in it (cannot be undone)
lifecycle {
prevent_destroy = true
}
}
output "sftp" {
value = "sftp -P ${gyro_backup_space.yedek.port} ${gyro_backup_space.yedek.user}@${gyro_backup_space.yedek.host}"
}
# password is sensitive: pass it to a secret store / configuration, never print it
# gyro_backup_space.yedek.password
import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.put("https://www.gyrohosting.com/api/v1/client/cloud/backup-spaces/12345/server", headers=h, json={"server_id": 1}, timeout=60)
r.raise_for_status()
print(r.json()["data"])