Esx. Settings. Inventory. Reports. Transition Summary. Hosts Get

Esx. Settings. Inventory. Reports. Transition Summary. Hosts Get

Returns the image and transition summaries of standalone hosts defined in the Esx.Settings.Inventory.Reports.TransitionSummary.Hosts.GetParams which is passed 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.lifecycleSettings.Read.
  • The resource HostSystem referenced by the property Esx.Settings.Inventory.Reports.TransitionSummary.Hosts.GetParams.hosts requires VcIntegrity.lifecycleSettings.Read.
  • The resource Folder referenced by the property Esx.Settings.Inventory.Reports.TransitionSummary.Hosts.GetParams.folders requires VcIntegrity.lifecycleSettings.Read.
  • The resource Datacenter referenced by the property Esx.Settings.Inventory.Reports.TransitionSummary.Hosts.GetParams.datacenters requires VcIntegrity.lifecycleSettings.Read.
Request
URI
GET
https://{api_host}/esx/settings/inventory/reports/transition-summary/hosts
COPY
Query Parameters
Esx.Settings.Inventory.Reports.TransitionSummary.Hosts.GetParams
spec
Required

Describe the inventory objects on which the specified operation will be performed.

string of array
hosts
Optional

List of standalone hosts on which the specified operation needs to be executed.

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.TransitionSummary.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.

string of array
folders
Optional

List of folders on which the specified operation will be executed. Internally each folder entity will be expanded to individual baseline managed 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 baseline managed standalone hosts.

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.TransitionSummary.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.

string of array
datacenters
Optional

List of the data-centers on which the specified operation will be executed. Internally each data-center entity will be expanded to individual baseline managed 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.TransitionSummary.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.

Authentication
This operation uses the following authentication methods.
Responses
200

Summary containing image details and transition status of the entities passed in input

Returns Esx.Settings.Inventory.Reports.TransitionSummary.Hosts.Info of type(s) application/json 
"Esx.Settings.Inventory.Reports.TransitionSummary.Hosts.Info Object"

400

If invalid Esx.Settings.Inventory.Reports.TransitionSummary.Hosts.GetParams is passed as an input

Returns Vapi.Std.Errors.InvalidArgument of type(s) application/json 
"Vapi.Std.Errors.InvalidArgument Object"

401

If the caller is not authenticated

Returns Vapi.Std.Errors.Unauthenticated of type(s) application/json 
"Vapi.Std.Errors.Unauthenticated Object"

403

If the caller is not authorized to invoke the interface.

Returns Vapi.Std.Errors.Unauthorized of type(s) application/json 
"Vapi.Std.Errors.Unauthorized Object"

404

If some of the provided inventories doesn't exist.

Returns Vapi.Std.Errors.NotFound of type(s) application/json 
"Vapi.Std.Errors.NotFound Object"

500

If there is unknown internal error. The accompanying error message will contain more details.

Returns Vapi.Std.Errors.Error of type(s) application/json 
"Vapi.Std.Errors.Error Object"

503

If the service is not available.

Returns Vapi.Std.Errors.ServiceUnavailable of type(s) application/json 
"Vapi.Std.Errors.ServiceUnavailable Object"

Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/esx/settings/inventory/reports/transition-summary/hosts?spec=v
On This Page
Esx.settings.inventory.reports.transition Summary.hosts Operations
GET
Esx. Settings. Inventory. Reports. Transition Summary. Hosts Get