Ansichten:
Verwenden Sie die folgenden Strategien, um die Leistung Ihrer API- und SDK-Aufrufe zu verbessern.

Minimieren Sie die Antwortgröße des Computers

Wenn Sie beschreiben, auflisten und suchen Computer, können Sie die Informationen angeben, die im zurückgegebenen Computer-Objekt enthalten sind. Wenn Sie nur die Informationen zurückgeben, die Sie benötigen, dauert es weniger Zeit, bis die Antwort Ihren Client erreicht.
Computereigenschaften, die einfache Werte sind, werden immer im zurückgegebenen Computer-Objekt enthalten. Sie steuern jedoch die Einbeziehung von Eigenschaften, die komplexe Werte haben (die Werte sind andere Objekte). Das folgende JSON stellt die Datenstruktur eines Computer-Objekts dar. Die Werte komplexer Eigenschaften werden durch geschweifte Klammern {...} dargestellt.
{
  "hostName": "string",
  "displayName": "string",
  "description": "string",
  "lastIPUsed": "string",
  "platform": "string",
  "groupID": 0,
  "policyID": 0,
  "assetImportanceID": 0,
  "relayListID": 0,
  "agentFingerPrint": "string",
  "applianceFingerPrint": "string",
  "lastAgentCommunication": 0,
  "lastApplianceCommunication": 0,
  "lastSendPolicyRequest": 0,
  "lastSendPolicySuccess": 0,
  "agentVersion": "string",
  "computerStatus": {...},
  "computerSettings": {...},
  "interfaces": {...},
  "biosUUID": "string",
  "azureARMVirtualMachineSummary": {...},
  "azureVMVirtualMachineSummary": {...},
  "ec2VirtualMachineSummary": {...},
  "noConnectorVirtualMachineSummary": {...},
  "vmwareVMVirtualMachineSummary": {...},
  "workspaceVirtualMachineSummary": {...},
  "esxsummary": {...},
  "ID": 0,
  "antiMalware": {...},
  "webReputation": {...},
  "firewall": {...},
  "intrusionPrevention": {...},
  "integrityMonitoring": {...},
  "logInspection": {...},
  "applicationControl": {...},
  "ESXSummary": {...},
  "SAP": {...}
}
Zum Beispiel, wenn Sie eine Liste von Computer-IDs benötigen, können Sie alle Computer auflisten und angeben, dass keine der komplexen Eigenschaften in den zurückgegebenen Computer-Objekten enthalten sind. Wenn Sie am Status des Agenten interessiert sind, fügen Sie die computerStatus-Eigenschaft hinzu und keine anderen komplexen Eigenschaften.
Warnung
Warnung
Alle Eigenschaften sind standardmäßig in den zurückgegebenen Computer-Objekten enthalten.
Die Methoden oder Funktionen der ComputersApi-Klasse, die Computer beschreiben, auflisten und durchsuchen, definieren einen expand-Parameter, der steuert, welche Eigenschaften enthalten sind. Der expand-Parameter ist eine Liste von Zeichenfolgenwerten. Die Expand-Klasse definiert die Zeichenfolgenwerte, die in der Liste enthalten sein können. (Für eine Liste der Zeichenfolgenwerte siehe die Beschreibung des Expand-Parameters für die Beschreibungs-, Listen- und Suchoperationen von Computern im API-Referenzhandbuch.)
Der folgende Code, aus einem Beispiel im Bericht über den Computerstatus-Leitfaden, erhält eine Liste von Computern, die die Computerstatus-Eigenschaft enthalten.
expand = api.Expand()
expand.add(api.Expand.computer_status)

computers_api = api.ComputersApi(api.ApiClient(configuration))
computers = computers_api.list_computers(api_version, expand=expand.list(), overrides=False)
In diesem Beispiel ähnelt die in den Computer-Objekten zurückgegebene Information dem folgenden JSON:
{
  "hostName": "string",
  "displayName": "string",
  "description": "string",
  "lastIPUsed": "string",
  "platform": "string",
  "groupID": 0,
  "policyID": 0,
  "assetImportanceID": 0,
  "relayListID": 0,
  "agentFingerPrint": "string",
  "applianceFingerPrint": "string",
  "lastAgentCommunication": 0,
  "lastApplianceCommunication": 0,
  "lastSendPolicyRequest": 0,
  "lastSendPolicySuccess": 0,
  "agentVersion": "string",
  "computerStatus": {...},
  "biosUUID": "string",
  "ID": 0,
}
Tipp
Tipp
Die Expand-Klasse definiert mehrere Zeichenfolgen, die es erleichtern, die Eigenschaften anzugeben, die in die Computer-Objekte aufgenommen werden sollen (der genaue Name der Zeichenfolge variiert je nach SDK-Sprache):
  • none: Enthält nur die einfachen Eigenschaftswerte und keine komplexen Eigenschaften. This value significantly increases performance und ist nützlich, wenn nur minimale Informationen wie die Computer-IDs benötigt werden.
  • all: Enthält alle Eigenschaften. Dies ist der Standardwert.
  • allVirtualMachineSummaries: Enthält alle Zusammenfassungsmerkmale der virtuellen Maschine wie EC2, Azure, VMWare.
  • allSecurityModules: umfasst alle Eigenschaften des Sicherheitsmoduls wie Anti-Malware, Intrusion Prevention und Application Control.
Warnung
Warnung
Der Standardwert für den expand-Parameter ist all. Wenn Sie null oder keinen Wert für den Parameter angeben, werden alle Computerinformationen zurückgegeben.

Verwenden Sie den Parameter "overrides"

Wenn Sie viele große Objekte von Server- und Workload Protection abrufen, kann das Einbeziehen nur der überschriebenen Eigenschaftswerte die Größe der zurückgegebenen Objekte erheblich reduzieren. Viele API-Aufrufe definieren einen overrides-Parameter, der steuert, ob die Antwort nur die Überschreibungen enthält, die auf der angezielten Ressource konfiguriert sind, oder alle effektiven Eigenschaften einschließt.
Tipp
Tipp
Für weitere Informationen siehe den Leitfaden zu den Überschreibungsparametern.
Wenn Sie beispielsweise die IDs aller Richtlinien benötigen, können Sie die Methode oder Funktion der PoliciesApi-Klasse verwenden, die Richtlinien mit overrides auf true gesetzt auflistet. Wenn viele der Eigenschaften der Richtlinie geerbt werden, kann das Abrufen von Überschreibungen die Antwortgröße erheblich reduzieren. Die ID wird immer zurückgegeben, unabhängig vom Wert des Überschreibungsparameters.
policies_api = api.PoliciesApi(api.ApiClient(configuration))
policies_with_overrides = policies_api.list_policies(api_version, overrides=True)

Regelzuweisungen direkt konfigurieren

Sie können Regelzuweisungen für Richtlinien und Computer mithilfe der folgenden Klassen konfigurieren:
  • PolicyFirewallRuleAssignmentsApi und ComputerFirewallRuleAssignmentsApi
  • PolicyIntegrityMonitoringRuleAssignmentsRecommendationsApi und ComputerIntegrityMonitoringRuleAssignmentsRecommendationsApi
  • PolicyIntrusionPreventionRuleAssignmentsRecommendationsApi und ComputerIntrusionPreventionRuleAssignmentsRecommendationsApi
  • PolicyLogInspectionRuleAssignmentsRecommendationsApi und ComputerLogInspectionRuleAssignmentsRecommendationsApi
Die Verwendung dieser Klassen ist leistungsfähiger als die Konfiguration von Regelzuweisungen über das Sicherheitsmodul-Erweiterungsobjekt eines Policy- oder Computer-Objekts. Um beispielsweise eine Firewall-Regel zuzuweisen, verwenden Sie die Methode oder Funktion der PolicyFirewallRuleAssignmentsApi-Klasse, die eine Firewall-Regel zu einer bestimmten Richtlinie hinzufügt. Der weniger leistungsfähige Weg, die Regel zuzuweisen, besteht darin, die Regel zu einem FirewallPolicyExtension-Objekt hinzuzufügen, das Objekt zu einem Policy-Objekt hinzuzufügen und dann PoliciesApi zu verwenden, um die Richtlinie zu ändern.
Für vollständige Informationen über die Fähigkeiten dieser Klassen finden Sie diese in den Abschnitten Richtlinien und Computer der API-Referenz.

Direkt mit einzelnen Einstellungen interagieren

Um die Antwortgröße bei der Interaktion mit Richtlinien-, Computer- und Systemeinstellungen zu minimieren, interagieren Sie direkt mit den einzelnen Richtlinieneinstellungen, anstatt eine Richtlinie zu ändern.
Wie in Erstellen und Konfigurieren einer Richtlinie beschrieben, gibt es zwei Möglichkeiten, wie Sie mit Richtlinieneinstellungen interagieren können:
  • Verwenden Sie die PoliciesApi-Klasse, um eine einzelne Richtlinieneinstellung abzurufen, zu ändern oder zurückzusetzen. Die Antwort enthält ein SettingValue-Objekt.
  • Verwenden Sie die PoliciesApi-Klasse, um eine Richtlinie abzurufen oder zu ändern. Die Antwort enthält ein Policy-Objekt, das ein PolicySettings-Objekt umfasst.
Ein SettingValue-Objekt, das einen String-Wert enthält, ist viel kleiner als ein Policy-Objekt, das alle Eigenschaftswerte und Einstellungswerte einer Richtlinie enthält.
Verwenden Sie in ähnlicher Weise die PoliciesApi-Klasse, um direkt mit einzelnen Standardrichtlinieneinstellungen zu interagieren, die ComputersApi-Klasse für einzelne Computereinstellungen und die SystemSettingsApi-Klasse für einzelne Systemeinstellungen (siehe Computer konfigurieren, um Richtlinien zu überschreiben und Server- und Workload Protection-Systemeinstellungen konfigurieren).

Seite Ihrer Suchergebnisse

Wenn möglich, rufen Sie Suchergebnisse in Seiten ab, wenn Sie eine große Anzahl von Objekten von Server- und Workload Protection abrufen, um eine Überlastung der Serverressourcen zu vermeiden. Wenn Sie eine Verringerung der Managerleistung bei der Durchführung einer Suche feststellen, überarbeiten Sie Ihren Code, um eine Reihe von Suchen durchzuführen, die kleinere Ergebnismengen zurückgeben.
Weitere Informationen finden Sie im Abschnitt „Suchergebnisse einschränken und Paging“ des Ressourcen suchen-Leitfadens.