AgentConfigInfo
A description of what should be put on a host.
By setting the productLineId and hostVersion, you can specify the types of hosts for which to use the ConfigInfo.
This structure may be used only with operations rendered under /eam.
{
"_typeName": "string",
"productLineId": "string",
"hostVersion": "string",
"ovfPackageUrl": "string",
"ovfSslTrust": {
"_typeName": "string"
},
"ovfEnvironment": {
"_typeName": "string",
"ovfProperty": [
{
"_typeName": "string",
"key": "string",
"value": "string"
}
]
},
"vibUrl": "string",
"vibSslTrust": {
"_typeName": "string"
},
"vibMatchingRules": [
{
"_typeName": "string",
"vibNameRegex": "string",
"vibVersionRegex": "string"
}
],
"vibName": "string",
"dvFilterEnabled": false,
"rebootHostAfterVibUninstall": false,
"vmciService": [
"string"
],
"ovfDiskProvisioning": "string",
"vmStoragePolicies": [
{
"_typeName": "string"
}
]
}The product line ID of the host.
Examples of values are "esx" or "embeddedEsx". If omitted, the host's product line ID is not considered when matching an AgentPackage against a host.
A dot-separated string of the host version.
Examples of values are "4.1.0" "3.5", "4.*" where * is a wildcard meaning any version minor version of the major version 4. If omitted, the host version will not be considered when matching an AgentPackage against a host. This property is not used if AgencyConfigInfoEx.vmPlacementPolicy is set. It is client's responsibility to trigger an agency upgrade with a new AgentConfigInfo.ovfPackageUrl.
The URL of the solution's agent OVF package.
If not set, no agent virtual machines are installed on the hosts covered by the scope. If AgencyConfigInfoEx.vmPlacementPolicy is set, the VM needs to be agnostic to the different host versions inside the cluster.
Specifies an SSL trust policy.
This structure may be used only with operations rendered under /eam.
Since: vEAM API 8.2
The OvfEnvironment is used to assign OVF environment properties in the AgentConfigInfo.
It specifies the values that map to properties in the agent virtual machine's OVF descriptor.
This structure may be used only with operations rendered under /eam.
An optional URL to an offline bundle.
If not set, no VIB is installed on the hosts in the scope. Offline bundles are only supported on 4.0 hosts and later.
VIB downgrade is not permitted - in case a VIB with the same name, but lower version is installed on a host in the scope the VIB installation on that host will not succeed.
If two or more agents have the same VIB with different versions on the same host, the install/uninstall behaviour is undefined (the VIB may remain installed, etc.).
The property is not used if AgencyConfigInfoEx.vmPlacementPolicy is set.
Specifies an SSL trust policy.
This structure may be used only with operations rendered under /eam.
Since: vEAM API 8.2
Deprecated vIB matching rules are no longer supported by EAM. Same overlaps with VIB dependency requirements which reside in each VIB's metadata.
Optional Vib matching rules.
If set, the Vib, specified by vibUrl, will be installed either
- if there is installed Vib on the host which name and version match the regular expressions in the corresponding rule
- or there isn't any installed Vib on the host with name which matches the Vib name regular expression in the corresponding rule. Vib matching rules are usually used for controlling VIB upgrades, in which case the name regular expression matches any previous versions of the agency Vib and version regular expression determines whether the existing Vib should be upgraded.
For every Vib in the Vib package, only one Vib matching rule can be defined. If specified more than one, it is not determined which one will be used. The Vib name regular expression in the Vib matching rule will be matched against the name of the Vib which will be installed. Only rules for Vibs which are defined in the Vib package metadata will be taken in account.
Deprecated use VIB metadata to add such dependency.
An optional name of a VIB.
If set, no VIB is installed on the host. The host is checked if a VIB with vibName is already installed on it. Also the vibUrl must not be set together with the vibUrl.
Deprecated that is a custom setup specific for a particular agency. The agency owner should do it using other means, e.g. AgencyConfigInfo.manuallyMarkAgentVmAvailableAfterPowerOn or AgencyConfigInfo.manuallyMarkAgentVmAvailableAfterProvisioning hooks. Support for this has been removed. Seting this to true will no longer have any effect.
If set to true, the hosts in the scope must be configured for DvFilter before VIBs and agent virtual machines are deployed on them.
If not set or set to false, no DvFilter configuration is done on the hosts.
Deprecated express that requirement in the VIB descriptor with 'live-remove-allowed=false'.
An optional boolean flag to specify whether the agent's host is rebooted after the VIB is uninstalled.
If not set, the default value is false. If set to true, the agent gets a VibRequiresHostReboot issue after a successful uninstallation.
If set the virtual machine will be configured with the services and allow VMCI access from the virtual machine to the installed VIB.
AgentVM disk provisioning type.
Defaults to none if not specified.
Defines the storage policies configured on Agent VMs.
Storage policies are configured on all VM related objects including disks. NOTE: The property needs to be configured on each update, otherwise vSphere ESX Agent Manager will unset this configuration for all future agent VMs.