Tüm ürün hatlarına (bulut sunucu, VDS, fiziksel sunucu, kurumsal mail, izleme, depolama, lisans, ...) genel köprü. Müşteri panelinde bir hizmette yapılabilen her şey bir modül aracı ya da metodudur ve burada erişilebilir. GET /cloud/services/{id}/tools ile başlayın: o hizmetin araçlarını, eylemlerini ve güvenlik politikasını (read, confirm, secret) döndürür.
# veri kaynağı gyro_services: https://registry.terraform.io/providers/gyro-hosting/gyro/latest/docs/data-sources/services
data "gyro_services" "mail" {
product_line = "mail"
}
import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/cloud/services", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])
const res = await fetch("https://www.gyrohosting.com/api/v1/client/cloud/services", {
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}`);
Bir araç eylemi çalıştır (posta kutusu oluştur, snapshot'tan dön, ...)Kapsam: services_writerunServiceToolActionBu işlemin OpenAPI parçası
Gövde alanları aracın kendi alanlarıdır (araç verisine ve rehberdeki modül tablosuna bakın). Keşif yanıtında confirm işaretli eylemler "confirm": true ister.
Parametreler
Alan
in
Tür
Açıklama
idzorunlu
path
integer
toolzorunlu
path
string
actionzorunlu
path
string
İstek gövdesi
Alan
Tür
Açıklama
confirm
boolean
Yanıtlar
202
Accepted — data: object
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 ...)
Hizmetin takma adını ve etiketlerini getirKapsam: services_readgetServiceLabelBu işlemin OpenAPI parçası
Hizmetlerinizden birinin (her ürün hattı) müşteri tanımlı takma adı ve renkli etiketleri. Etiketsiz hizmet "nickname": null ve "tags": [] döner. Etiketler yalnız hizmet sahibine görünür; devirden sonra eski sahibin etiketi gösterilmez.
Parametreler
Alan
in
Tür
Açıklama
idzorunlu
path
integer
Service id
Yanıtlar
200
Label — data: ServiceLabel
401
Missing, invalid or revoked key
403
Key lacks the scope, IP not allowed, or feature disabled
404
Not found — also returned for objects owned by someone else
429
Too many requests (rate_limited); see the Retry-After and X-RateLimit-* headers
# kaynak gyro_service_label: https://registry.terraform.io/providers/gyro-hosting/gyro/latest/docs/resources/service_label
# Give any service a nickname and colour tags. The nickname becomes the service title in the
# client area; the product name and service number stay below it.
resource "gyro_server" "api" {
plan = "standart-2-4"
region = "tr-ist-1"
image = "ubuntu-24.04"
confirm_order = true
}
resource "gyro_service_label" "api" {
service_id = tonumber(gyro_server.api.id)
nickname = "api-gateway"
tags = [
{ name = "production", color = "green" },
{ name = "api" }, # colour omitted: a stable default is chosen by the API
]
}
# An existing service (e.g. a container environment) by its number.
resource "gyro_service_label" "ecs" {
service_id = 12345
nickname = "gyro-ecs-1"
tags = [{ name = "staging", color = "orange" }]
}
import os, uuid, requests
h = {"Authorization": "Bearer " + os.environ["GYRO_TOKEN"]}
r = requests.get("https://www.gyrohosting.com/api/v1/client/cloud/services/12345/label", headers=h, timeout=60)
r.raise_for_status()
print(r.json()["data"])
const res = await fetch("https://www.gyrohosting.com/api/v1/client/cloud/services/12345/label", {
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}`);
Hizmetin takma adını ve/veya etiketlerini ayarlaKapsam: services_writeupdateServiceLabelBu işlemin OpenAPI parçası
nickname, tags ya da ikisini gönderin; gönderilmeyen alan değişmez. nickname "" veya null temizler; tags tüm etiketlerin yerine geçer, [] temizler. Etiket "ad" ya da {"name", "color"}; bilinmeyen/eksik renk için sabit varsayılan atanır. Aynı adlı (büyük/küçük harf duyarsız) etiketler birleştirilir. Sınır: anahtar başına dakikada 30 etiket yazması (429 rate_limited). Alt hesap anahtarı label:edit eylemi ister. Hatalar: 422 nothing_to_update, invalid_nickname, invalid_tags; 404 service_not_found (başka hesabın hizmeti dahil) veya feature_unavailable.
Parametreler
Alan
in
Tür
Açıklama
idzorunlu
path
integer
Service id
İstek gövdesi
Alan
Tür
Açıklama
nickname
string | null
"" or null clears the nickname. No control characters.
tags
array | null
Replaces all tags; [] or null clears them. Item: a tag name, or {"name", "color"} (CLI: use --data for colours).
Yanıtlar
200
Saved label — data: ServiceLabel
401
Missing, invalid or revoked key
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 ...)
429
Too many requests (rate_limited); see the Retry-After and X-RateLimit-* headers
gyro service label set 12345 --help # tüm seçenekler
# kaynak gyro_service_label: https://registry.terraform.io/providers/gyro-hosting/gyro/latest/docs/resources/service_label
# Give any service a nickname and colour tags. The nickname becomes the service title in the
# client area; the product name and service number stay below it.
resource "gyro_server" "api" {
plan = "standart-2-4"
region = "tr-ist-1"
image = "ubuntu-24.04"
confirm_order = true
}
resource "gyro_service_label" "api" {
service_id = tonumber(gyro_server.api.id)
nickname = "api-gateway"
tags = [
{ name = "production", color = "green" },
{ name = "api" }, # colour omitted: a stable default is chosen by the API
]
}
# An existing service (e.g. a container environment) by its number.
resource "gyro_service_label" "ecs" {
service_id = 12345
nickname = "gyro-ecs-1"
tags = [{ name = "staging", color = "orange" }]
}
