Guía de la API de automatización virtual › Ejemplos de la API de automatización virtual › Implementación de la recopilación (/deploycollection)

Implementación de la recopilación (/deploycollection)

Puede utilizarse la API para implementar la recopilación de eventos en máquinas virtuales. Incluye el cuerpo de un mensaje especificando el perfil del evento que desea utilizarse.

Nota: Los perfiles de la recopilación de eventos se configuran desde la interfaz de usuario de CA User Activity Reporting Module. Para obtener más información acerca de los perfiles de recopilación de eventos, consulte la Ayuda en línea de CA User Activity Reporting Module.

El procedimiento siguiente muestra cómo implementar una recopilación mediante la utilidad cURL.

Siga estos pasos:

1. Cree un archivo de texto llamado deploy.txt que contenga los parámetros de la implementación:

   <deploymentRequest>
   <tenant>Valor predeterminado</tenant><profile>prueba de syslog</profile><host>syslogsource.ca.com</host><ip>10.0.0.0</ip><credentials><user>root</user><password>contraseña_raíz</password></credentials></deploymentRequest>
   

   Están disponibles los parámetros siguientes:

   <tenant>

   Nombra el cliente virtual en el cual desea implementarse la recopilación de eventos. Para obtener una lista de los clientes disponibles, utilice /tenants.

   <profile>

   Nombra el perfil de recopilación de eventos que desea utilizarse. Para obtener una lista de los perfiles disponibles, utilice /collectionprofiles.

   <host>

   Nombra el origen del evento para la recopilación de eventos.

   <ip>

   Especifica la dirección IP del origen del evento para la recopilación de eventos.

   <credentials>

   Contiene los elementos que proporcionan el nombre del usuario y la contraseña para el acceso al origen del evento. Este elemento solamente es necesario para perfiles de conexión establecidos para el requerimiento de credenciales.

2. Abra una ventana de la línea de comandos y vaya al directorio donde guardó el archivo de texto.
3. Introduzca el comando siguiente:

   curl -u usuario_elm:contraseña_elm-k -H "Accept: application/xml" -H "Content-Type: application/xml" -X POST -d @deploy.txt "https://nombre_host:8443/rest/am/1/deploycollection"
   

   El elemento -d @deploy.txt proporciona el contenido del archivo de texto en el cuerpo de la solicitud.

Si la implementación es correcta, el usuario recibe un mensaje HTTP 201 (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>

La respuesta muestra el URI del recurso implementado después de Location.

Esta información puede utilizarse para modificar o suprimir la implementación. En el ejemplo anterior, el recurso implementado es un conector pasivo, de modo que aparece el elemento eventTarget. EventTarget muestra el puerto y la dirección IP del conector, permitiendo así la configuración del origen del evento para la transmisión de los eventos al destino correcto.

Si no hay suficiente capacidad en el grupo de agentes seleccionado, aparece un mensaje de error (HTTP 507).