Añadir elemento del inventario

Versión del producto: 10.11

Último modificado: 31 julio 2024

Añade un elemento del inventario.

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 para VMware

Copiar 
 curl --request POST \
    --url https://<Director_IP_address>:4443/c/router \
    --header "content-type: application/json" \
    --cookie @cookies.txt \
    --data '{
        "action": "VmwareDiscovery",
        "method": "create",
        "data": [{
                "vid": null,
                "name": "10.30.29.17",
                "host": "10.30.29.17",
                "port": "443",
                "username": "domain\\username",
                "password": "password",
                "confirmed": false
                }],
        "type": "rpc",
        "tid": 1}'

Ejemplo de solicitud de máquina física

Copiar 
 curl --request POST \
    --url https://<Director_IP_address>:4443/c/router \
    --header "content-type: application/json" \
    --cookie @cookies.txt \
    --data '{
        "action": "PhysicalDiscovery",
        "method": "create",
        "data": [{
                "vid": null,
                "name": "10.10.10.10",
                "host": "10.10.10.10",
                "type": "LINUX",
                "username": "admin",
                "password": "password",
                "confirmed": false,
                "sshPort": 22,
                "useExistingAgent": false
                }],
        "type": "rpc",
        "tid": 1}'

Ejemplo de solicitud para Microsoft 365.

Copiar 
curl --request POST \
    --url https://<Director_IP_address>:4443/c/router \
    --header "content-type: application/json" \
    --cookie @cookies.txt \
    --data '{
        "action": "Office365Discovery",
        "method": "create",
        "data": [{
                "vid": null,
                "authType": "CLIENT_SECRET",
                "clientCertificateVid": null,
                "clientId": "5gh5def0-d223-4b54-8abf-69f7fac9212f",
                "discoveryServices": ["EXCHANGE_ONLINE"],
                "name": "Office365 mailbox",
                "tenantId": "e8f23c02-3278-4097-8ec5-3b91849e34570",
                "clientSecret": "4y8uIekFy02nJKl.B1.K.7gmj0E_.f3Rx7"                }],
        "type": "rpc",
        "tid": 1}'

Campos de solicitud

Campo

Tipo

Valor(es)

 Descripción
action string

VmwareDiscovery para VMware

HypervDiscovery para Hyper-V

AwsDiscovery para AWS

%s dfsdf %4592%lkjlkj% para Nutanix AHV
PhysicalDiscovery para Máquinas físicas

Office365Discovery para Microsoft 365.

Hpe3ParDiscovery para HPE 3PAR

HpeNimbleDiscovery para HPE Nimble

NetAppDiscovery para NetApp

HpeAlletraDiscovery para HPE Alletra

HpePrimeraDiscovery para HPE Primera

 La acción que se invoca
method string 
creación
 El método que se invoca
data array
Datos de un elemento de inventario por crear
type string rpc Tipo de protocolo de comunicación
tid integer 1 ID de transacción. Se utiliza para identificar la solicitud tanto por parte del cliente como del servidor

Datos

Campo

Tipo

Descripción

vid

string Elementos del inventario VID. Utilice este campo sólo con el método update

type

string

Válido para Hyper-V, Amazon EC2 y máquinas físicas. Valores posibles:

  • Para Hyper-V:%s dfsdf %4607%lkjlkj%, o CLUSTER
  • Para AWS:NORMAL, US_GOVCLOUD, or CHINA_BEIJING
  • Para servidor físico:%s dfsdf %4610%lkjlkj%, o LINUX

name

string Nombre del elemento del inventario

host

string Elementos del inventario host

port

string Puerto de elementos del inventario. Omitido para servidores físicos

username

string Nombre de usuario. Incluye el nombre de dominio si es necesario

password

string Contraseña de usuario

confirmed

boolean %s dfsdf %4618%lkjlkj% si necesita añadir una versión no compatible de un elemento del inventario; false en caso contrario. Puede que no funcione cuando
ejecuta el job. Utilice este campo sólo con el método update.

sshPort

integer El puerto SSH que se utilizará durante la instalación

useExistingAgent

boolean %s dfsdf %4618%lkjlkj% si desea utilizar un agente de máquina física existente en el host; false en caso contrario. Válido sólo para máquinas físicas

accessKey

string Llave de acceso. Válido sólo para AWS EC2

secretAccessKey

string Clave de acceso secreta. Válido sólo para AWS EC2

authType

string Tipo de autenticación, puede ser %s dfsdf %4626%lkjlkj% o "CERTIFICATE". Validez limitada a Microsoft 365.

clientCertificateVid

string VID del certificado de cliente utilizado para la autenticación. Si ha optado por la autenticación secreta del cliente, deje este parámetro como null. Validez limitada a Microsoft 365.
tenantId string Azure Tenant ID creado al registrar su cuenta de Microsoft 365 en el Portal Azure. Validez limitada a Microsoft 365.
clientId string ID de cliente de Azure creado al registrar su cuenta de Microsoft 365 en el portal de Azure. Validez limitada a Microsoft 365.
clientSecret string Azure Client Secret obtenido del Portal Azure. Validez limitada a Microsoft 365.
discoveryServices string Tipo de servicio que se va a añadir. Puede ser uno o varios de los siguientes: "EXCHANGE_ONLINE", "EXCHANGE_ONLINE_GROUP", "ONE_DRIVE", "SHARE_POINT", "TEAM". Validez limitada a Microsoft 365.

skipHttpsListenerConfig

boolean true para utilizar un certificado personalizado para el oyente HTTPS. Válido sólo para Hyper-V
deviceType string Tipo de dispositivo. Puede ser uno de los siguientes: "HPE3PAR", "HPE_PRIMERA", "HPE_ALLETRA_9000", "HPE_NIMBLE", "HPE_ALLETRA_5000_6000"

Ejemplo de respuesta para VMware

Copiar 
 {
    "action": "VmwareDiscovery",
    "method": "create",
    "tid": "1",
    "type": "rpc",
    "message": null,
    "where": null,
    "cause": null,
    "data": 1
}

Muestra de respuesta para máquinas físicas

Copiar 
 {
    "action": "PhysicalDiscovery",
    "method": "create",
    "tid": "1",
    "type": "rpc",
    "message": null,
    "where": null,
    "cause": null,
    "data": 2
}

Muestra de respuesta para Microsoft 365.

Copiar 
 {
    "action": "Office365Discovery",
    "method": "create",
    "tid": "1",
    "type": "rpc",
    "message": null,
    "where": null,
    "cause": null,
    "data": 3
}

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
 int

ID del elemento de inventario creado