Trasy i weryfikacja domen

Lumin Shield ↗Otwórz panel ↗

Tworzenie tras, aktualizacja i instrukcje DNS.

Dostępne operacje

Metoda	Ścieżka	Rola
GET	/v1/orgs/{org}/routes	member
POST	/v1/orgs/{org}/routes	admin; 201
GET	/v1/orgs/{org}/routes/{id}	member
PUT	/v1/orgs/{org}/routes/{id}	admin
DELETE	/v1/orgs/{org}/routes/{id}	admin; 204
GET	/v1/orgs/{org}/routes/{id}/dns	member
POST	/v1/orgs/{org}/routes/{id}/verify	admin

Utworzenie trasy

Wyślij poniższy obiekt do POST /v1/orgs/{org}/routes. Zastąp PROFILE_UUID, POOL_UUID i przykładowy adres rzeczywistymi wartościami z własnej organizacji.

{
  "name": "Survival",
  "domains": ["mc.example.com"],
  "backends": [{"address": "192.0.2.10:25565", "weight": 1}],
  "balancing": "round_robin",
  "profileId": "PROFILE_UUID",
  "ipListIds": [],
  "branding": {},
  "target": {"kind": "pool", "id": "POOL_UUID"},
  "enabled": true
}

domains to tablica nazw bez protokołu i portu. Backend ma pole address z portem oraz weight. target.kind przyjmuje pool lub dedicated; identyfikator musi wskazywać dostępny zasób. balancing wybiera obsługiwany algorytm, np. round_robin lub least_players.

Aktualizacja

PUT przyjmuje pełną konfigurację trasy. Nie działa jak częściowy PATCH. Pobierz istniejącą trasę i świadomie zbuduj obiekt do aktualizacji; w odpowiedzi GET domains zawiera obiekty stanu, a w żądaniu PUT mają być same nazwy.

Wyłączenie enabled zatrzymuje udostępnianie trasy. Usunięcia i zmiany domen wykonuj po potwierdzeniu właściwego ID we własnym systemie.

Weryfikacja

Nowa domena może mieć verified: false. Po utworzeniu wyświetl klientowi instrukcję DNS i uruchom weryfikację. Samo 201 nie oznacza gotowości serwera do przyjmowania ruchu.