URL anfordern
GET
https://api.dotcom-monitor.com/config_api_v1/Gerät/ {device_id}
Holen Sie sich die Geräteeinstellung anhand ihrer ID.
Pfadparameter
Feld | drucktype | Erforderlich | beschreibung |
---|---|---|---|
device_id |
Schnur |
true |
Die eindeutige ID eines Überwachungsgeräts. Informationen zum Anfordern einer Liste der Geräte-IDs innerhalb einer Plattform finden Sie unter API: Get Device List by Platform. |
Erfolgsreaktion
Beschreibung der Felder
Verwenden Sie diese Felder, um Informationen zu einem Gerät in Ihren API-Anforderungen anzugeben.
Feld |
drucktype |
beschreibung | ||
Avoid_Simultaneous_Checks |
boolesch |
Gibt an, ob die gleichzeitige Überprüfung von den mehreren Überwachungsstandorten zulässig ist. Nur für ServerView-Geräte verfügbar.
Beispiel:
|
||
Alert_Silence_Min |
int32 |
NUR LESEN. Definiert den Zeitraum in Minuten, in dem alle Warnungen deaktiviert sind. Um Warnungen zu deaktivieren, verwenden Sie API: Warnungen für Gerät deaktivieren oder API: Warnungen für mehrere Geräte deaktivieren.
Beispiel:
|
||
False_Positive_Check |
boolesch |
Wenn ein Fehler erkannt wurde, führen wir eine Reihe von Überprüfungen aus, um sicherzustellen, dass es sich nicht um eine falsche Warnung handelt. Diese Prüfungen können je nach Fehlertyp und Anzahl der Aufgaben im Gerät einige Zeit in Anspruch nehmen. Dies kann zu einer Verzögerung der Ausfallzeitwarnung führen. Sie können die falsche positive Überprüfung (“true”) deaktivieren, um eine sofortige Ausfallzeitwarnung sicherzustellen, aber es kann zu einigen “falschen” Warnungen führen. Wir empfehlen, “False positive check” NICHT zu deaktivieren.
Beispiel:
|
||
Standorte |
Array von int32 |
Ein Array mit Standort-IDs, die einem bestimmten Gerät zugewiesen sind. In den Anforderungen muss mindestens ein Speicherort angegeben werden.
Beispiel:
|
||
Schilder |
Array der Zeichenfolge |
Ein Array, das die Namen der Tags enthält, die einem bestimmten Gerät zugewiesen sind.
Beispiel:
|
||
Send_Uptime_Alert |
boolesch |
Wenn diese Option aktiviert ist, erhalten Sie eine Warnung, wenn alle erkannten Fehler behoben werden.
Beispiel:
|
||
Status_Description |
Schnur |
NUR LESEN. Beschreibung des aktuellen Gerätezustands.
Beispiel:
|
||
Verschieben |
boolesch |
Die Überwachung kann auf eine Pause eingestellt werden, indem ein Gerät aufgesetzt wird.
Beispiel:
|
||
Owner_Device_Id |
int32 |
Dieses Feld gibt die Besitzergeräte-ID an.
Beispiel:
|
||
Frequenz |
int32 |
Dieses Feld spiegelt die Überwachungsfrequenz in Sekunden wider.
Beispiel:
|
||
Filter_Id |
int32 |
Dieses Feld gibt die einem Gerät zugewiesene Filter-ID wieder.
Beispiel:
|
||
Scheduler_Id |
int32 |
Dieses Feld gibt die einem Gerät zugewiesene Scheduler-ID wieder.
Beispiel:
|
||
Benachrichtigungen |
Array von Objekten |
Gibt eine Liste der Warnungseinstellungen an
Beispiel #1:
Beispiel #2:
|
||
E_Mail_Flag |
boolesch |
Definiert, ob eine E-Mail-Warnung gesendet wird.
Beispiel:
|
||
E_Mail_Address |
Schnur |
Gibt eine E-Mail-Adresse für eine E-Mail-Benachrichtigung an.
Beispiel:
|
||
E_Mail_TimeInterval_Min |
int32 |
Dieses Feld ermöglicht es, ein Intervall zwischen E-Mail-Benachrichtigungen in Minuten festzulegen.
Beispiel:
|
||
WL_Device_Flag |
boolesch |
Legt fest, ob eine Warnung für drahtlose Geräte gesendet wird.
Beispiel:
|
||
WL_Device_Email_Address |
Schnur |
Dieses Feld gibt ein drahtloses Gerät, z. B. Telefon oder Pager, für Warnungen an.
Beispiel:
|
||
WL_Device_TimeInterval_Min |
int32 |
In diesem Feld können Sie ein Intervall zwischen den Warnungen drahtloser Geräte in Minuten festlegen.
Beispiel:
|
||
Pager_Flag |
boolesch |
Definiert, ob Pagerwarnungen gesendet werden.
Beispiel:
|
||
Pager_Area_Code |
Schnur |
Pager-Vorwahl.
Beispiel:
|
||
Pager_Phone |
Schnur |
Pager Telefon.
Beispiel:
|
||
Pager_Num_Code |
Schnur |
Code für numerische Pager.
Beispiel:
|
||
Pager_TimeInterval_Min |
int32 |
Dieses Feld ermöglicht das Festlegen eines Intervalls zwischen Pagerwarnungen in Minuten.
Beispiel:
|
||
Phone_Flag |
boolesch |
Definiert, ob Telefonanrufwarnungen stattfinden. Um Benachrichtigungen per Telefon satzwert auf “true” zu empfangen und Telefonnummer anzugeben. Telefonbenachrichtigungen sind interaktiv, sodass Sie nachfolgende Benachrichtigungen verschieben können, sobald eine Warnung eingegangen ist.
Beispiel:
|
||
Phone_Area_Code |
Schnur |
Wenn der Ländercode “1” ist (z. B. in den USA, Kanada und der Karibik), geben Sie die Vorwahl und die Nummer ein (z. B. 952-5134349). Verwenden Sie für alle anderen Ländercodes das Präfix “011”, die Ländervorwahl und die Telefonnummer (z. B. 011-44-95-2244392).
Beispiel:
|
||
Phone_Phone |
Schnur |
Telefonnummer.
Beispiel:
|
||
Phone_TimeInterval_Min |
int32 |
Dieses Feld ermöglicht das Festlegen eines Intervalls zwischen Telefonanrufen.
Beispiel:
|
||
SMS_Flag |
boolesch |
Definiert, ob SMS-Benachrichtigungen gesendet werden.
Beispiel:
|
||
SMS_Phone |
Schnur | Eine Telefonnummer mit einer Ländervorwahl (z. B. US – 1 952 513 4349; 449524 4392). Verwenden Sie KEINE internationale Vorwahl, z. B. “011” in der Nummer.
Beispiel:
|
||
SMS_TimeInterval_Min |
int32 |
Dieses Feld ermöglicht das Festlegen eines Intervalls zwischen SMS-Warnungen.
Beispiel:
|
||
Script_Flag |
boolesch |
Dieses Feld definiert, ob Warnungen von benutzerdefinierten Warnungsskripts ausgeführt werden.
Beispiel:
|
||
Script_Batch_File_Name |
Schnur |
Benutzerdefinierter Skript-Dateiname. Skript muss bereits auf dem Server installiert sein.
Beispiel:
|
||
Script_TimeInterval_Min |
int32 |
Dieses Feld ermöglicht das Festlegen eines Intervalls zwischen benutzerdefinierten Skriptwarnungen.
Beispiel:
|
||
Notification_Groups |
Array von Objekten |
Gibt aktive Warnungsgruppen mit ihrer ID und Zeitverschiebung an. Zeitverschiebung ist eine Option, mit der Sie einen Warnungseskalationsprozess erstellen können, der auf der Dauer der Fehlerbedingung basiert. Die Zeitintervalle der Warnungseskalation reichen von unmittelbar bis drei Stunden.
Beispiel:
|
||
Number_Of_Tasks |
int32 |
LESEN Sie NUR Feld. Zeigt die Anzahl der Aufgaben unter dem angegebenen Gerät an.
Beispiel:
|
||
int32 |
LESEN Sie NUR Feld. Die eindeutige Geräte-ID. Wird automatisch bei der Erstellung eines neuen Geräts zugewiesen. Wird verwendet, um ein Gerät in Anforderungen anzugeben.
Beispiel:
|
|||
Platform_Id |
int32 |
LESEN Sie NUR Feld. Jede Plattform (ServerView, UserView etc.) hat ihre eigene ID. Hier erfahren Sie, wie Sie die IDs der Plattformen erhalten.
Beispiel:
|
||
name |
Schnur |
Der Name des Geräts.
Beispiel:
|