Lista de elementos del inventario de nivel superior

Versión del producto: 10.11

Último modificado: 31 julio 2024

Lista todos los elementos del inventario de la plataforma seleccionada.

La plataforma se selecciona invocando un determinado action. Consulte la descripción de los campos de solicitud. Method es el mismo.

Punto final

https://<Director_IP_address>:4443/c/router

Punto final inquilino

Para los inquilinos del producto multi-tenant el punto final debe ser:

https://<Dirección_IP_director>:4443/t/<tenant_UUID>/c/router

Ejemplo de solicitud

rizo

Copiar

curl --request POST \
    --url https://<Director_IP_address>:4443/c/router \
    --header "content-type: application/json" \
    --cookie @cookies.txt \
    --data '{
        "action": "VmwareDiscovery",
        "method": "getDiscoveryItems",
        "data": null,
        "type": "rpc",
        "tid": 1}'

Campos de solicitud

Campo	Tipo	Valor(es)
`action`	string	`VmwareDiscovery` para VMware `HypervDiscovery` para Hyper-V `AwsDiscovery` para AWS `NutanixDiscovery` para Nutanix AHV `PhysicalDiscovery` para servidores físicos
`method`	string	getDiscoveryItems
`data`	array	`null`
`type`	string	`rpc`
`tid`	integer	1

Muestra de respuesta

rizo

Copiar

 {
  "action": "VmwareDiscovery",
  "method": "getDiscoveryItems",
  "tid": "1",
  "type": "rpc",
  "message": null,
  "where": null,
  "cause": null,
  "data": {
    "items": [
      {
        "host": "hostname",
        "username": "administrator@hostname",
        "port": 443,
        "vid": "VMWARE_DISCOVERY_ITEM-1",
        "name": "vCenter",
        "state": "OK",
        "status": "NONE",
        "changeStatus": "NONE",
        "preventModification": false,
        "locked": false,
        "wasDiscoveredOnce": true,
        "wasEdited": false,
        "progress": 0,
        "targetVid": "VMWARE_VC-1",
        "hostCount": 15,
        "vmCount": 185,
        "alertErrorCode": null,
        "alertTitle": null,
        "alertDescription": null
      }
    ]
  }
}

Campos de respuesta

Campo	Valor	Descripción
`message`	string	Mensaje si la solicitud ha fallado
`where`	string	Referencia al método en el que se ha producido el problema
`cause`	string	Causa del fallo
`data`	Json	Información sobre el elemento del inventario

Datos

Campo	Valor	Descripción
`host`	string	Dirección IP o nombre de host del elemento del inventario
`username`	string	Nombre de usuario para acceder al elemento del inventario
`port`	int	Puerto TCP abierto en un host para la comunicación con el producto.
`vid`	string	VID del elemento del inventario
`name`	string	Nombre para mostrar del elemento del inventario
`accessKey`	string	Una clave de acceso. Válido sólo para AWS EC2
`confirmToProceed`	boolean	`true` si se requiere la confirmación del usuario. Válido sólo para AWS EC2
`type`	string	Se utiliza para AWS, Hyper-V y servidores físicos. Valores posibles: Para AWS EC2:`NORMAL, US_GOVCLOUD, CHINA_BEIJING` Para Hyper-V:`HOST, CLUSTER` Para físico:`LINUX, WINDOWS`
`subtype`	string	Se utiliza para AWS, Hyper-V y servidores físicos. Valores posibles: Para AWS: `NORMAL, US_GOVCLOUD, CHINA_BEIJING` Para Hyper-V: `HOST, CLUSTER` Para físico: `LINUX, WINDOWS`
`state`	string	Estado del elemento del inventario: OK, advertencia, inaccesible, error
`status`	string	Estado de la operación actual en el elemento de inventario: actualización o ninguno
`changeStatus`	string	Estado de modificación del elemento del inventario. Valores posibles: `NONE, CREATE_PENDING, CHANGE_PENDING`
`preventModification`	boolean	Comprueba si el elemento está bloqueado para la edición manual
`locked`	boolean	Comprueba si el elemento está bloqueado por alguna tarea
`wasDiscoveredOnce`	boolean	Comprueba si el elemento del inventario fue detectado una vez.
`wasEdited`	boolean	Compruebe si se ha editado el elemento del inventario
`progress`	int	Progreso de la operación que se está ejecutando (porcentaje)
`targetVid`	string	Primer elemento específico de la plataforma en el inventario bajo el elemento de detección. Hyper-V/VMware/Nutanix: host/cluster. AWS/servidor físico: ninguno
`hostCount`	int	Número de hosts dentro del elemento del inventario
`vmCount`	int	Número de máquinas virtuales dentro del elemento del inventario
`alertErrorCode`	largo	El código de error de la alerta (si existe)
`alertTitle`	string	El título de la alerta (si existe)
`alertDescription`	string	La descripción de la alerta (si existe)