Servicio de descubrimiento

El recurso del servicio de descubrimiento inicia un descubrimiento con o sin un perfil.

Descripción

Utilice este tipo de solicitud para iniciar un descubrimiento utilizando cualquier perfil actualmente definido, o sin perfiles.

URL

scheme//nombre_host:port/rest/discovery/start/nombre_ejecución

donde:

Esquema: Esquema del URL (HTTP: o HTTPS:).
nombre de host: Nombre de host TCP/IP o dirección IP numérica del servidor de TADDM.
puerto: Puerto TCP/IP del servidor de TADDM para el tipo de conexión que está utilizando (9430 para HTTP o 9431 para HTTPS).
nombre_ejecución: Nombre de la ejecución de descubrimiento.

Métodos HTTP

POST: Inicia un descubrimiento. No debe haber ningún descubrimiento en curso. Debe enviar la solicitud del URL utilizando el operador HTTP POST.

Parámetros

feed= {json|xml}

Formato que utilizar para los datos devueltos. Especifique json o xml. Este parámetro es opcional.

Si no especifica el parámetro feed, el servidor utiliza el formato especificado por la cabecera HTTP Aceptar (application/json o application/xml). Si no se especifica la cabecera, los resultados se devuelven en formato JSON.

guids=valores

Uno o varios identificadores exclusivos globales (GUID) de objetos que se han descubierto previamente. Utilice este parámetro para ejecutar un redescubrimiento en objetos existentes, si ha habilitado el redescubrimiento.

profile=nombre_perfil

Nombre del perfil que se va a utilizar. El perfil especificado debe existir.

scope=valores

Uno o varios ámbitos, separados por comas. Los valores pueden ser cualquiera de los siguientes:

Nombre de ámbito definido
Dirección IP específica o nombre de host (por ejemplo, 192.168.1.71 o server.example.com)
Dirección IP específica que excluir, entre paréntesis (por ejemplo, (192.168.1.71))
Rango de direcciones IP (por ejemplo, 10.10.10.1-10.10.10.20)
Subred (por ejemplo, 10.10.20.0/255.255.255.0

Pueden aparecer entre paréntesis una dirección IP, un rango de direcciones o una subred para indicar que se deberían excluir del ámbito. Por ejemplo, 192.168.1.1-192.168.1.72,(192.168.1.71) incluiría todas las direcciones IP del rango especificado, excepto 192.168.1.71.

locationTag=valor

El valor de la etiqueta de ubicación que hay que definir para los objetos creados durante el descubrimiento.

addressSpace=valor

El nombre de espacio de direcciones definido para todos los objetos IpAddress o IpNetwork creados durante un descubrimiento.

Ejemplo de entrada

Este ejemplo inicia un descubrimiento utilizando el perfil Level 3 Discovery, con un ámbito que incluye los hosts 192.168.100.101 y 102.168.100.102. Puede utilizar cualquier herramienta o programa de utilidad que pueda realizar una solicitud HTTP y enviarla utilizando el operador POST.

http://example.com:9430/rest/discovery/start/TestRun2?profile=Level%203
%20Discovery&scope=192.168.100.101,192.168.100.102

Devoluciones

Si la solicitud es correcta, se devuelve el código de respuesta HTTP 200, así como el mensaje Discovery start submitted. Si ya hay un descubrimiento en curso, la solicitud falla y se devuelve un mensaje de error. A continuación, puede utilizar el recurso del estado de descubrimiento para supervisar el progreso del descubrimiento.