FTP Monitor aktualisieren (Status ändern)

PATCH /api/ftp-monitors/:ftpMonitorPublicId

Authentifizierung

Authorization: Bearer <token>

Parameter

ftpMonitorPublicId (Pfad, erforderlich): Öffentliche UUID des FTP Monitors.

Request Body

status (optional): active, maintenance, disabled (akzeptiert auch inactive/paused und normalisiert zu disabled)
customerId (optional, number): Muss zur selben Organisation gehören
name (optional, string)
hostname (optional, string): Muss ein Hostname sein (kein Protokoll, kein Pfad)
port (optional, number | null)
checkInterval (optional, number)
timeoutSeconds (optional, number)
allowedCheckCountryCodes (optional, string[] | null): ISO-3166-1 alpha-2, z.B. "DE", "ES"
checkMode (optional, string): protocol (Standard) | tcp. Beim Wechsel zu tcp werden gespeicherte Zugangsdaten gelöscht: der Monitor führt nur eine reine TCP-Port-Erreichbarkeitsprüfung durch und ftpConfig wird nicht gespeichert. Beim Zurückwechseln zu protocol läuft wieder die vollständige FTP-Login-Prüfung; neue Zugangsdaten über ftpConfig/config mitschicken.
ftpConfig (optional, object): Ersetzt die gespeicherte FTP-Config (JSON)
config (optional, object): Alias von ftpConfig

Hinweis: Read-only Nutzer dürfen nur status ändern.

Hinweis: Wenn du ftpConfig/config weglässt, bleibt die bestehende Config unverändert.

{ "status": "maintenance" }

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X PATCH \
 "$BASE_URL/api/ftp-monitors/55555555-5555-4555-8555-555555555555" \
 -H "Authorization: Bearer $TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"status":"active","allowedCheckCountryCodes":["DE","ES"],"ftpConfig":{"user":"monitor","password":"<ftp-password>","secure":false}}'

Response

{
 "id": 400,
 "status": "maintenance",
 "config": {},
 "ftpConfig": {}
}

Häufige Fehler

400 Invalid status wenn status ungültig ist
401 Unauthorized wenn du nicht authentifiziert bist
403 Forbidden wenn du keine Schreibrechte hast (z.B. Read-only versucht andere Felder zu ändern, oder Global Supporter)
404 FTP monitor not found wenn der Monitor nicht existiert