Uptimeify Docs
MonitoreICMP-Monitore

ICMP Monitor erstellen

Erstellt einen neuen ICMP Monitor.

POST /api/icmp-monitors

Authentifizierung

Erfordert eine gültige Session.

  • Header: Authorization: Bearer <token>

Request Body

{
  "customerId": "6764e84f-f02a-43e6-a46d-cecaec556723",
  "name": "Ping Gateway",
  "hostname": "claas.sh",
  "status": "active",
  "checkInterval": 5,
  "timeoutSeconds": 10,
  "icmpConfig": {
    "packetSize": 56,
    "count": 4
  }
}

Felder

  • customerId (number | string, required)
    • Akzeptiert die interne numerische Kunden-ID oder die Customer-publicId-UUID.
  • name (string, required)
  • hostname (string, required)
    • Muss nur Hostname oder IP sein (kein Protokoll wie https://, kein Pfad wie /ping).
  • status (string, optional)
    • Erlaubt: active, maintenance, disabled, paused, inactive
    • Hinweis: paused / inactive werden zu disabled normalisiert.
  • checkInterval (number, optional)
  • timeoutSeconds (number, optional)
  • icmpConfig (object, optional)
    • Wird als config JSON am Monitor gespeichert.

icmpConfig (vom Worker unterstützte Keys)

  • packetSize (number)
    • Default: 56
  • count (number)
    • Default: 3

cURL

curl -X POST "https://YOUR_DOMAIN/api/icmp-monitors" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "6764e84f-f02a-43e6-a46d-cecaec556723",
    "name": "Ping Gateway",
    "hostname": "claas.sh",
    "status": "active",
    "checkInterval": 5,
    "timeoutSeconds": 10,
    "icmpConfig": { "packetSize": 56, "count": 4 }
  }'

Response

{
  "id": 123,
  "organizationId": 1,
  "customerId": 2,
  "name": "Ping Gateway",
  "hostname": "claas.sh",
  "port": null,
  "status": "active",
  "checkInterval": 5,
  "timeoutSeconds": 10,
  "allowedCheckCountryCodes": null,
  "notificationPhoneNumber": null,
  "notificationEmail": null,
  "lastCheckedAt": null,
  "createdAt": "2026-02-26T12:00:00.000Z",
  "updatedAt": "2026-02-26T12:00:00.000Z",
  "config": {
    "packetSize": 56,
    "count": 4
  },
  "icmpConfig": {
    "packetSize": 56,
    "count": 4
  }
}

Fehler

  • 400 Invalid Customer identifier
  • 400 Ungültiger Hostname oder ungültiger Request Body
  • 401 Unauthorized
  • 403 Forbidden (z. B. readonly oder global supporter)
  • 404 Kunde nicht gefunden

ICMP Monitore

Verwalte ICMP (Ping) Monitore.

ICMP Monitor löschen

Löscht einen ICMP Monitor.

Auf dieser Seite

AuthentifizierungRequest BodyFeldericmpConfig (vom Worker unterstützte Keys)cURLResponseFehler