URL anfordern

Das Gerät kann mit zwei Methoden erstellt werden:

PUT https://api.dotcom-monitor.com/config_api_v1/devices
Bereitstellen https://api.dotcom-monitor.com/config_api_v1/devices?verb=PUT

Header-Parameter

Content-Type: application/json
Beispiel Für einen Post-Textkörper
{
    "Avoid_Simultaneous_Checks": false,
    "Alert_Silence_Min": -2815394,
    "False_Positive_Check": false,
    "Locations": [
        1,
        4,
        6,
        14,
        15,
        17,
        19,
        23,
        43,
        71,
        73
    ],
    "Frequency": 10800,
    "Filter_Id": 7791,
    "Platform_Id": 1,
    "Name": "new device"
}

Erforderliche Körperparameter

Um JSON-Objektparameter für ein neues Gerät anzugeben, wird empfohlen, zuerst eine vorhandene Geräteinformation abzurufen und die Antwort als Beispiel für ein neues Geräteobjekt zu verwenden. Die Beschreibung der allgemeinen Felder finden Sie in der API: Übersicht über Gerätemethoden.

Um Warnungen für ein Gerät zu deaktivieren, verwenden Sie API: Warnungen für Gerät deaktivieren oder API: Warnungen für mehrere Geräte deaktivieren.

Die folgenden Felder sind im Anforderungstext erforderlich:

Feld

drucktype

Erforderlich/Optional

beschreibung

Standorte

Array von int32

Erforderlich

*Außer MetricsView-Geräte

Ein Array mit Standort-IDs, die einem bestimmten Gerät zugewiesen sind. In den Anforderungen muss mindestens ein Speicherort angegeben werden.

Beispiel:
"Locations": [1, 2, 4, 5, 8]

Frequenz

int32

Erforderlich

Dieses Feld spiegelt die Überwachungsfrequenz in Sekunden wider.

Beispiel:
"Frequency": 10800

Platform_Id

int32

Erforderlich

Alle Geräte werden von 5 Plattformen verteilt. Jede Plattform hat ihre eigene “Platform_Id”.

Potenzielle Werte für Platform_Id:
Plattformname Platform_Id
BrowserView 7
MetricsView 3
Serverview 1
Webview 12
WICHTIG: UserView wird von dotcom-monitor API v.1 nicht unterstützt. Userview-Skripte können nur mit dem EveryStep Scripting Toolerstellt/aufgezeichnet werden.
Beispiel:
"Id": 7

name

Schnur

wahlfrei

Es wird empfohlen, einen eindeutigen Namen für das Gerät anzugeben.

Beispiel:
"Name": "new name"
Wenn Sie ein neues Gerät einrichten und keinen Filter zuweisen, wird dem Gerät automatisch der Standardfilter zugewiesen.

Erfolgsreaktion

Beispielantwort
{
    "Success":true,
    "Result":8666
}
Feld

drucktype

beschreibung

Ergebnis

int32

Die eindeutige ID für das Gerät.