SFTP backup space with a hard quota, bound to ONE server of your account and reachable only from that server's IPv4 addresses (tr-ist-1). Order, connection details, password reset, bind to another server, cancel. Size changes use the generic plan change endpoints.
Orderable sizes (50 GB to 1 TB) with prices per billing cycle (fixed EUR, VAT excluded; list_amount = strike-through list price) and servers: the servers of the account a space can be bound to. Empty plans = not orderable for this account yet. available: false = no capacity right now.
Responses
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
# resource 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}`);
Orders ONE backup space and pays from the account balance (never a stored card). The space is bound to server_id, one of your active servers (Gyro Cloud tr-ist-1, TR VDS, managed or dedicated); it may be omitted when the account has exactly one. Only that server's IPv4 addresses can connect (SFTP, port 2201). Billed per cycle (fixed EUR prices charged in the account currency, VAT excluded) and renewed from the balance like other services. Send "dry_run": true for a quote; a real order needs "confirm": true and an Idempotency-Key header. The space is set up within about a minute (backup_space.statepending -> active); then read the password with GET /cloud/backup-spaces/{id}/credentials. Errors: 402 insufficient_balance; 403 not_available (not on sale for this account), orders_disabled; 409 server_required (no active server), capacity_unavailable; 422 confirm_required (with quote), product_not_orderable, cycle_invalid, server_id_required, invalid_server, invalid_quantity; 429 daily_limit.
Parameters
Field
in
Type
Description
Idempotency-Keyrequired
header
string
Unique per logical request (e.g. a UUID). Replays within 24 hours return the stored answer.
Request body
Field
Type
Description
plan
string
plan from GET /cloud/backup-spaces/plans (50gb, 100gb, 250gb, 500gb, 1tb)
# resource 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
Service row plus backup_space: SFTP host, port, user, writable path, size, usage, bound server, allowed IPs and state. The password is not included (see /credentials).
Parameters
Field
in
Type
Description
idrequired
path
integer
Backup space (service) id
Responses
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
# resource 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 is required. immediate=true cancels now: SFTP access stops and the space with EVERY file in it is deleted permanently within about a minute (no snapshot, no grace period; cannot be undone). Without immediate a cancellation request is filed and the space keeps working until it is processed. 403 immediate_disabled when the operator turned immediate deletion off.
Parameters
Field
in
Type
Description
idrequired
path
integer
Backup space (service) id
confirmrequired
query
boolean
immediate
query
boolean
delete the space and every file now (cannot be undone)
Responses
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 ...)
# resource 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}`);
SFTP connection with the passwordScope: services_writegetBackupSpaceCredentialsOpenAPI for this operation
Host, port, user, path and the SFTP password (Cache-Control: no-store). Needs services_write because it reveals a secret. 409 not_ready while the space is being set up.
Parameters
Field
in
Type
Description
idrequired
path
integer
Backup space (service) id
Responses
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)
Creates a new random password and returns it once. The old password stops working at once and open SFTP sessions are closed; update your backup jobs. "confirm": true required. 409 not_actionable when the space is not active; 502 backend_unavailable = try again in a few minutes.
Parameters
Field
in
Type
Description
idrequired
path
integer
Backup space (service) id
Request body
Field
Type
Description
confirmrequired
boolean (True)
Responses
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 ...)
Binds the space to server_id (one of your active servers; optional when the account has one). From then on only that server's IPv4 addresses can connect; the previous server loses access at once. Files are not touched. When the bound server's IP changes or the server is cancelled, access follows automatically.
Parameters
Field
in
Type
Description
idrequired
path
integer
Backup space (service) id
Request body
Field
Type
Description
server_id
integer
server id
Responses
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 # all flags
# resource 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"])