Esx. Settings. Inventory. Reports. Summary. Hosts Get
Returns the information about the software specifications from the repository assigned to standalone hosts as well as operations summary performed on the standalone hosts under inventory defined in the Esx.Settings.Inventory.Reports.Summary.Hosts.GetParams as an input.
This operation was added in vSphere API 9.0.0.0.
Returns an authorization error if you do not have all of the privileges described as follows:
- Operation execution requires VcIntegrity.lifecycleSoftwareRemediation.Read.
- The resource HostSystem referenced by the property Esx.Settings.Inventory.Reports.Summary.Hosts.GetParams.hosts requires VcIntegrity.lifecycleSoftwareRemediation.Read.
- The resource Folder referenced by the property Esx.Settings.Inventory.Reports.Summary.Hosts.GetParams.folders requires VcIntegrity.lifecycleSoftwareRemediation.Read.
- The resource Datacenter referenced by the property Esx.Settings.Inventory.Reports.Summary.Hosts.GetParams.datacenters requires VcIntegrity.lifecycleSoftwareRemediation.Read.
Describe the inventory objects on which the specified operation will be performed.
List of standalone hosts on which the operations summary needs to be generated.
This property was added in vSphere API 9.0.0.0.
This property is optional and it is only relevant when the value of type is Esx.Settings.Inventory.Reports.Summary.Hosts.GetParams.InventoryType.HOST.
When clients pass a value of this schema as a parameter, the property must contain identifiers for the resource type: HostSystem. When operations return a value of this schema as a response, the property will contain identifiers for the resource type: HostSystem.
List of folders on which the operations summary needs to be generated. Internally the folder entities will be expanded to individual standalone hosts which are underneath the designated folder. If the list contains the managed object ID of the root folder, the specified operation will be executed on all standalone hosts in the vCenter.
This property was added in vSphere API 9.0.0.0.
This property is optional and it is only relevant when the value of type is Esx.Settings.Inventory.Reports.Summary.Hosts.GetParams.InventoryType.FOLDER.
When clients pass a value of this schema as a parameter, the property must contain identifiers for the resource type: Folder. When operations return a value of this schema as a response, the property will contain identifiers for the resource type: Folder.
List of data-centers on which the operations summary needs to be generated. Internally the data-center entities will be expanded to individual standalone hosts which are underneath the designated data-center.
This property was added in vSphere API 9.0.0.0.
This property is optional and it is only relevant when the value of type is Esx.Settings.Inventory.Reports.Summary.Hosts.GetParams.InventoryType.DATACENTER.
When clients pass a value of this schema as a parameter, the property must contain identifiers for the resource type: Datacenter. When operations return a value of this schema as a response, the property will contain identifiers for the resource type: Datacenter.
Summary containing the software specifications from the repository assigned to standalone hosts and operations summary performed on the standalone hosts under inventory passed in as input.
"Esx.Settings.Inventory.Reports.Summary.Hosts.Info Object"If invalid Esx.Settings.Inventory.Reports.Summary.Hosts.GetParams is passed as an input.
"Vapi.Std.Errors.InvalidArgument Object"If the caller is not authenticated
"Vapi.Std.Errors.Unauthenticated Object"If the caller is not authorized to invoke the interface.
"Vapi.Std.Errors.Unauthorized Object"If some of the provided inventories doesn't exist.
"Vapi.Std.Errors.NotFound Object"If there is unknown internal error. The accompanying error message will contain more details.
"Vapi.Std.Errors.Error Object"If the service is not available.
"Vapi.Std.Errors.ServiceUnavailable Object" curl -H 'Authorization: <value>' https://{api_host}/esx/settings/inventory/reports/summary/hosts?spec=v