Elementos individuales

Versión del producto: 10.11

Último modificado: 31 julio 2024

Devuelve información sobre un elemento de inventario especificado.

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": "VmwareDiscovery",
        "method": "getDiscoveryItem",
        "data": [1],
        "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 servidor físico
method string

getDiscoveryItem

data array de int ID del elemento de inventario dentro de su grupo de plataforma
type string rpc
tid integer 1

Muestra de respuesta

Copiar 
{
  "action": "VmwareDiscovery",
  "method": "getDiscoveryItem",
  "tid": "1",
  "type": "rpc",
  "message": null,
  "where": null,
  "cause": null,
  "data": {
    "host": "vc65.zenlar.int",
    "username": "administrator@vsphere.local",
    "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 Parámetros. Ver más abajo

data

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

type

string

Tipo de elemento del inventario

subType

string

Subtipo del elemento de inventario

sizeKb

int

Tamaño total del disco del servidor físico

confirmToProceed

boolean

true si la devolución de información sobre el elemento de inventario requiere confirmación

accessKey

string

Clave de acceso para un elemento de inventario de Amazon EC2.
name string Nombre para mostrar del elemento del inventario
state string Estado del elemento del inventario: OK, WARNING, INACCESSIBLE, o ERROR
status string Estado de la operación actual en el elemento del inventario: %s dfsdf %4424%lkjlkj% o NONE
changeStatus string Estado de modificación del elemento del inventario: NONE, CREATE_PENDING, o 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 en curso (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: Elementos VID. Servidor físico: ID del elemento
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 int 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)