Add Inventory Item

Adds an inventory item.

Endpoint

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

Tenant Endpoint

For tenants of the multi-tenant product the endpoint must be:
https://<Director_IP_address>:4443/t/<tenant_UUID>/c/router

Request Example for VMware

Request Example for Physical Machine

Request Example for Microsoft 365

Request Fields

Field

Type

Value(s)

Description
action string

VmwareDiscovery for VMware

HypervDiscovery for Hyper-V

AwsDiscovery for AWS

NutanixDiscovery for Nutanix AHV
PhysicalDiscovery for Physical machines

Office365Discovery for Microsoft 365

Hpe3ParDiscovery for HPE 3PAR

HpeNimbleDiscovery for HPE Nimble

NetAppDiscovery for NetApp

HpeAlletraDiscovery for HPE Alletra

HpePrimeraDiscovery for HPE Primera

The action that is invoked
method string
create
The method that is invoked
data array
Data of an inventory item to be created
type string rpc Type of communication protocol
tid integer 1 Transaction ID. Used to identify the request by both the client and the server

Data

Field

Type

Description

vid

string Inventory item VID. Only use this field with the update  method

type


Valid for Hyper-V, Amazon EC2 and physical machines. Possible values:

  • For Hyper-V:HOST, or CLUSTER
  • For AWS:NORMAL, US_GOVCLOUD, or CHINA_BEIJING
  • For Physical Server:WINDOWS, or LINUX

name

string Inventory item name

host

string Inventory item host

port

string Inventory item port. Omitted for physical servers

username

string User name. Includes domain name if needed

password

string User password

confirmed

boolean true if you need to add an unsupported version of inventory item; false otherwise. It may not be working when
the job runs. Use this field only with the update method.

sshPort

integer The SSH port to be used during installation

useExistingAgent

boolean true if you would like to use an existing physical machine agent at the host; false otherwise. Valid for physical machines only

accessKey

string Access key. Valid for AWS EC2 only

secretAccessKey

string Secret access key. Valid for AWS EC2 only

authType

string Type of authentication, can be "CLIENT_SECRET" or "CERTIFICATE". Valid for Microsoft 365 only

clientCertificateVid

string VID of the client certificate used for authentication. If you opted for client secret authentication, then leave this parameter as null. Valid for Microsoft 365 only
tenantId string Azure Tenant ID created when registering your Microsoft 365 account in the Azure Portal. Valid for Microsoft 365 only
clientId string Azure Client ID created when registering your Microsoft 365 account in the Azure Portal. Valid for Microsoft 365 only
clientSecret string Azure Client Secret obtained from the Azure Portal. Valid for Microsoft 365 only
discoveryServices string Type of service to be added. Can be one or several of the following: "EXCHANGE_ONLINE", "EXCHANGE_ONLINE_GROUP", "ONE_DRIVE", "SHARE_POINT", "TEAM". Valid for Microsoft 365 only

Response Sample for VMware

Response Sample for Physical Machine

Response Sample for Microsoft 365

Response Fields

Field

Value

Description

message string

Message if the request failed

where string

Reference to the method where a problem occurred

cause string

Cause of failure

data
int

ID of the created inventory item