Hinweise zur REST-API

Online bearbeiten

Mit der REST-API können Sie große Datenmengen abrufen, die sich auf Computersysteme, Softwareinstanzen und die Lizenznutzung in Ihrer Umgebung beziehen. Diese Informationen können dann zur weiteren Verarbeitung und Analyse an andere Anwendungen weitergegeben werden.

Obwohl die Verwendung einzelner API-Anforderungen zum ausschließlichen Abrufen von Daten aus einer ausgewählten Untergruppe von Computern keine großen Auswirkungen auf die Leistung von hat, trifft dies nicht zu, wenn Daten in großen Mengen für alle Computersysteme gleichzeitig abgerufen werden. Eine solche Aktion erfordert die Verarbeitung großer Datenvolumen und wirkt sich immer auf die Anwendungsleistung aus.

Generell sollten die API-Anforderungen nicht zusammen mit anderen leistungsintensiven Tasks wie Software-Scans oder Datenimporten verwendet werden. Jeder Benutzer, der bei der Anwendung angemeldet ist, sowie die Anzahl der Aktionen, die während der REST-API-Aufrufe in der Webbenutzerschnittstelle ausgeführt werden, verringern ebenfalls die Leistung.
Wichtig: Stellen Sie jedes Mal, wenn Sie Daten über die REST-API abrufen wollen, sicher, dass die Verwendung von auf moderater Ebene erfolgt, damit die zusätzliche Workload, die sich aus der REST-API ergibt, die Anwendung nicht überlastet und Leistungsprobleme verursacht.
Wenn Sie sehr große Datenmengen abrufen, können Sie auch mehrere API-Anforderungen stellen und die Ergebnisse mithilfe der Parameter 'limit' und 'offset' paginieren, statt alle Daten gleichzeitig abzurufen:
  • Geben Sie mit dem Parameter 'limit' die Anzahl der abgerufenen Ergebnisse an:
    https://server_url:server_port/URL?token=token&countSwitch=1&limit=10000&offset=0
    Beispiel:
    https://192.0.2.2:9081/api/sam/v2/computers?token=token&countSwitch=1&limit=10000&offset=0
  • Wenn Sie die erste Anforderung auf 100.000 Ergebnisse begrenzen, hängen Sie die nächste Anforderung mit dem Parameter offset=100000 an, damit die bereits abgerufenen Einträge nicht erneut abgerufen werden:
    https://server_url:server_port/URL?token=token&countSwitch=1&limit=10000&offset=10000
    Beispiel:
    https://192.0.2.2:9081/api/sam/v2/computers?token=token&countSwitch=1&limit=10000&offset=10000
Hinweis: Die Parameter für Begrenzung und Offset können weggelassen werden, wenn Sie Daten von bis zu 50 Endpunkten abrufen. Bei Umgebungen mit etwa 200.000 Endpunkten wird empfohlen, die Daten für Computersysteme auf Seiten mit 100.000 Zeilen, für Softwareinstanzen auf Seiten mit 200.000 Zeilen und für die Lizenznutzung auf Seiten mit 300.000 Zeilen abzurufen.