Lista jerárquica de elementos del inventario

Versión del producto: 10.11

Último modificado: 31 julio 2024

Lista todos los elementos del inventario y sus hijos en una estructura jerárquica.

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

Copiar 
curl --request POST \
    --url https://<Director_IP_address>:4443/c/router \
    --header "content-type: application/json" \
    --cookie @cookies.txt \
    --data '{
        "action": "InventoryManagement",
        "method": "collect",
        "data": [{
            "viewType": "VIRTUAL_ENVIRONMENT",
            "rootNodeVid": null}],
        "type": "rpc",
        "tid": 9}'

Campos de solicitud

Campo
Tipo
Valor(es)
action string

InventoryManagement

method string 
recoja
data array Parámetros de la solicitud. Véase más abajo
type string rpc
tid int 1

Datos

Campo Tipo Descripción Valores posibles
viewType string Define la plataforma para la que debe devolverse el inventario.

VIRTUAL_ENVIRONMENT para el inventario de VMware

HYPERV_VIRTUAL_ENVIRONMENT para el inventario de Hyper-V

AWS_ENVIRONMENT para el inventario AWS

NUTANIX_VIRTUAL_ENVIRONMENT para el inventario de Nutanix

PHYSICAL_ENVIRONMENT para el inventario de servidores físicos
rootNodeVid string El VID del nodo padre. null para el de nivel superior

Muestras de respuesta

Copiar 
 {
  "action": "InventoryManagement",
  "method": "collect",
  "tid": "9",
  "type": "rpc",
  "message": null,
  "where": null,
  "cause": null,
  "data": {
    "children": [{
      "identifier": 1,
      "vid": "VMWARE_VC-1",
      "type": "VMWARE_VC",
      "subType": null,
      "name": "vCenter",
      "accessible": true,
      "isDisabled": false,
      "replicable": true,
      "hvType": "VMWARE",
      "flags": 0,
      "children": [{
          "identifier": 1,
          "vid": "VMWARE_DATACENTER-1",
          "type": "VMWARE_DATACENTER",
          "subType": null,
          "name": "DEV",
          "accessible": true,
          "isDisabled": false,
          "replicable": true,
          "hvType": "VMWARE",
          "flags": 0,
          "children": [{
            "version": "6.5.0",
            "hwVersion": 13,
            "free": false,
            "standalone": false,
            "managed": true,
            "powerState": "ON",
            "lid": "VMWARE_VMWARE_ESX_host-2322_10.30.29.103_44454c4c-3800-1052-8042-c3c04f53334a",
            "sc": 1,
            "extendedInfo": null,
            "identifier": 1,
            "vid": "VMWARE_ESX-1",
            "type": "VMWARE_ESX",
            "subType": null,
            "name": "10.30.29.103",
            "accessible": true,
            "isDisabled": false,
            "replicable": true,
            "hvType": "VMWARE",
            "flags": 2,
            "children": null
          }]
        }
}

Campos de respuesta

Campo
Tipo
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 array Ver más abajo

data.children y data.children.children (niveles de vCenter y centro de datos)

Campo Tipo Descripción
identifier largo ID del Nodo
vid string Nodo VID
type string Tipo de nodo
subType string Subtipo del nodo
name string Nombre para mostrar

description

string

Descripción de los nodos
accesible boolean true si el nodo es accesible
isDisabled boolean true si el nodo está desactivado
replicable boolean true si el nodo se puede replicar
hvType string Tipo de plataforma
flags

Para hosts ESXi de VMware:

  • El bit 0 comprueba si el host ESXi está libre;
  • El primer bit comprueba si el host está gestionado por vCenter.

data.children.children.children (nivel del contenedor: host, cluster, folder, VM)

Campo Tipo Descripción
version string Versión de la plataforma
hwVersion largo Para VMware, Hyper-V y Nutanix, versión de hardware virtual máxima admitida
free boolean Para hosts ESXi: comprueba si el host está libre
standalone boolean true si el objeto es autónomo
managed boolean Para hosts ESXi: es gestionado por el vCenter
powerState string Estado de energía del objeto

memorySize

largo

host específico. Tamaño de la memoria

morId

string

host específico. ID de referencia de objeto gestionado de la máquina virtual
lid string Elemento identificador a efectos de licencias

hostCount

int

cluster específico. Recuento de host

largestMemorySize

largo

cluster específico. Mayor tamaño de memoria
sc int Recuento de zócalos

hostLid

string

VM específico. LID del host

hostSc

int

VM específico. Recuento de zócalos de CPU del host. Aplicable a Microsoft Hyper-V

hostVid

string

VM específico. VID del host

hostVersion

string

VM específico. Versión del host

isTemplate

boolean

VM específico. true si la máquina virtual es una plantilla

isWindowsPlatform

boolean

VM específico. true si la máquina virtual está en plataforma Windows

replicationState

string

VM específico. Estado de replicación

notSupportedReason

string

VM específico. Motivo por el que no es compatible

warningReason

string

VM específico. Motivo de la advertencia

isReplicatedFromBackupObject

boolean

VM específico. true si la máquina virtual se replica desde los backups
extendedInfo
Información ampliada (si existe)
identifier largo ID del objeto
vid string Objeto VID
type string Tipo de objeto
subType string Subtipo de objeto
name string Nombre para mostrar

description

string

Descripción del objeto
accessible boolean true si el objeto es accesible
isDisabled boolean true si el objeto está desactivado
replicable boolean true si el objeto puede ser replicado
hvType string Tipo de plataforma
flags int

Para hosts ESXi de VMware:

  • El bit 0 comprueba si el host ESXi está libre
  • El primer bit comprueba si el host está gestionado por vCenter