Handbuch zur API der virtuellen Automatisierung › API der virtuellen Automatisierung - Beispiele › Bereitstellen von Erfassungen (/deploycollection)

Bereitstellen von Erfassungen (/deploycollection)

Sie können diese API verwenden, um Ereigniserfassung auf einem virtuellen Computer bereitzustellen. Fügen Sie einen Nachrichtentext ein, in dem Sie angeben, welches Ereignisprofil Sie verwenden möchten.

Hinweis: Ereigniserfassungsprofile werden über die CA User Activity Reporting Module-Benutzeroberfläche konfiguriert. Weitere Informationen zur Konfiguration der Ereigniserfassungsprofile finden Sie in der CA User Activity Reporting Module-Online-Hilfe.

Der folgende Vorgang veranschaulicht, wie eine Erfassung mithilfe des cURL-Hilfsprogramms bereitgestellt wird.

Gehen Sie wie folgt vor:

1. Erstellen Sie eine Textdatei mit dem Namen "deploy.txt", die die Bereitstellungsparameter enthält:

   <deploymentRequest>
   <tenant>Default</tenant><profile>syslog test</profile><host>syslogsource.ca.com</host><ip>10.0.0.0</ip><credentials><user>root</user><password>rootpw</password></credentials></deploymentRequest>
   

   Folgende Parameter sind verfügbar:

   <tenant>

   Benennt den virtuellen Mandanten, auf dem Sie die Ereigniserfassung bereitstellen möchten. Sie können mithilfe von "/tenants" eine Liste der verfügbaren Mandanten abrufen.

   <profile>

   Benennt das Ereigniserfassungsprofil, das Sie verwenden möchten. Sie können mithilfe von "/collectionprofiles" eine Liste der verfügbaren Mandanten abrufen.

   <host>

   Benennt die Ereignisquelle, von der Sie Ereignisse erfassen möchten.

   <ip>

   Gibt die IP-Adresse der Ereignisquelle an, von der Sie Ereignisse erfassen möchten.

   <credentials>

   Enthält die Elemente, die den Benutzernamen und das Kennwort für den Zugriff auf die Ereignisquelle bereitstellen. Dieses Element ist nur für Verbindungsprofile erforderlich, die festgelegt werden, um Anmeldeinformationen zu erfordern.

2. Öffnen Sie eine Eingabeaufforderung, und wechseln Sie in das Verzeichnis, in dem die Textdatei gespeichert haben.
3. Geben Sie folgenden Befehl ein:

   curl -u elm_user:elm_password -k -H "Accept: application/xml" -H "Content-Type: application/xml" -X POST -d @deploy.txt "https://hostname:8443/rest/am/1/deploycollection"
   

   Das Element "-d @deploy.txt" stellt den Inhalt der Textdatei im Nachrichtentext der Anforderung bereit.

Wenn die Bereitstellung erfolgreich ist, erhalten Sie eine HTTP 201-Nachricht (CREATED):

HTTP/1.1 201 Created
Location: http://myelmhost:8443/rest/agentgroups/Agents/agents/014589ec-4b97-4179-8778-65b1671996f8/connectors/1cde5aa8-e11c-4c36-b7cc-712477c9f52f/sources/10.0.0.0
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<eventTarget>
    <host>10.0.0.0</host>
    <tcpPort>1468</tcpPort>
    <udpPort>40514</udpPort>
</eventTarget>

Die Antwort zeigt nach "Location:" den URI der bereitgestellten Ressource an.

Diese Informationen können verwendet werden, um die Bereitstellung zu ändern oder zu löschen. Im vorangehenden Beispiel ist die bereitgestellte Ressource ein passiver Connector, sodass das Element "eventTarget" angezeigt wird. "EventTarget" zeigt Informationen des Ports und der IP-Adresse für den Connector an und ermöglicht es Ihnen, die Ereignisquelle zu konfigurieren, um Ereignisse zum richtigen Ziel zu übertragen.

Wenn in der ausgewählten Agentengruppe nicht genügend Kapazität vorhanden ist, wird eine Fehlermeldung (HTTP 507) angezeigt.