AE REST-API – Mit Agenten arbeiten

Sie können einen vorkonfigurierten Agenten herunterladen und ein neues Agentenobjekt erstellen. Diese Funktion ist für WIN, UNIX, SQL und REST verfügbar.

Voraussetzung! Die für ein Centralized Agent Upgrade (CAU) erforderlichen Packs müssen installiert sein, damit Sie einen Agenten aus der Administration-Perspektive herunterladen können. Sie können die CAU-Packs von https://marketplace.automic.com/ herunterladen. Nachdem Sie sie heruntergeladen haben, müssen Sie sie auf Mandant 0 installieren. Dies kann auf der Seite Packs in der AdministrationPerspektive erfolgen. Weitere Informationen finden Sie unter Centralized Agent Upgrade (CAU).

Ein neues Agentenobjekt erstellen

Request: POST https://{host}:{port}/ae/api/v1/{client}/system/agents

Sie können eine POST-Anfrage verwenden, um ein neues Agentenobjekt zu erstellen. Die POST-Anfrage sendet den Namen des Agenten und die Vorlage, die verwendet wird, um ihn zu erstellen. Der Vorlagenname muss in der Variablen UC_OBJECT_TEMPLATE definiert werden.

Beispiel 

{
  "name": "WIN01",
  "template": "<WIN>"
}

Nachdem die Anforderung gesendet wurde, hat die Antwort den Status 200 OK und das neue Agentenobjekt ist in der Liste Agenten im Mandanten verfügbar, der in der Anfrage aufgerufen wurde.

Hinweis: Um diese Funktionalität zu verwenden, müssen Sie ein Benutzer im Mandanten sein, in dem Sie das Agentenobjekt erstellen möchten, und Sie müssen das Recht haben, auf die Administration-Perspektive zuzugreifen.

Um diese Funktionalität zu verwenden, muss das System wissen, wo die entsprechenden JCP- und REST-Endpunkte erreicht werden können. Sie können sie unter Verwendung der Parameter JCP_ENDPOINT und REST_ENDPOINT in der Variablen UC_SYSTEM_SETTINGS konfigurieren.

Mehr Informationen:

Vorkonfigurierte Agenten herunterladen

Anfrage: POST https://{host}:{port}/ae/api/v1/{client}/system/agents

Sie können eine POST-Anfrage verwenden, um einen vorkonfigurierten Agenten herunterzuladen. Nachdem die Anfrage gesendet wurde, hat die Antwort den Status 201 Erstellt und enthält die Datei agent.zip. Die ZIP-Datei enthält einen bin-Ordner, der die entsprechenden .jar- und .ini-Dateien enthält. Die neueste Version des Agenten wird heruntergeladen.

Sie können diese Funktion auch verwenden, um alle Parameter zu ändern und/oder einen ServiceManager hinzuzufügen.

Beispiel 

{
  "platform": "SQL",
  "name": "TEST09",
  "config_update" : "[GLOBAL]\nname=TEST08",
  "service_manager" : {
	"operating_system" : "Windows",
  	"operating_system_architecture" : "x64",
  	"config_update" : "[GLOBAL]\nport=8873"
  }
}

Die relevanten Parameter der INI-Datei werden entsprechend gefüllt. Der Parameter Name ist optional. Sind jedoch beide Parameter name und config_update definiert, wird die Definition des Parameters name verwendet.

UNIX (Linux)-Agenten

Sie müssen die Umgebungsvariablen SSL_CERT_DIR und SSL_CERT_FILE mit dem Benutzer festlegen, der den Agenten startet.

Mit diesen Variablen können Sie die Zertifikate aus dem TLS/SSL-Speicher laden. Die Zertifikate können entweder in einer Datei pro Zertifikat oder alle Zertifikate in einer .pem-Datei gespeichert werden:

  • SSL_CERT_DIR Speicherort der vertrauenswürdigen CA-Zertifikate, wobei jedes Zertifikat in einer separaten Datei abgelegt wird, z. B. /etc/ssl/certs/

  • SSL_CERT_FILE Speicherort der .pem-Datei mit allen vertrauenswürdigen CA-Zertifikaten, z. B. /etc/pki/tls/certs/ca-bundle.crt

Mehr Informationen:

Scripts verwenden

Sie können Scripts verwenden, um Agenten-Packs einfach zu erstellen, herunterzuladen und zu extrahieren sowie Agenten zu starten, die auf einem Windows- oder UNIX-System ausgeführt werden.

Wir haben einige Beispiele für Deployment-Scripts für SQL-, REST-, Windows- und UNIX-Agenten zusammengestellt. Sie ermöglichen es Ihnen, die Agenten bereitzustellen und zu starten, ohne Ihr eigenes Script erstellen zu müssen. Sie können auch separate Scripts, die in den Beispielen verwendet werden, zu einem großen Script zusammenführen.

Mehr Informationen:

Siehe auch: