Data Object - EventDescriptionEventDetail

Property of
EventDescription
Extends
DynamicData

Data Object Description

Each Event object provides an automatic event message string through its fullFormattedMessage property. However, you can use the EventDetail object's properties to format an event message string that is appropriate when viewed from a specific context. The variable information (vm.name, and so on) is derived from the Event object's event arguments (VmEventArgument, and so on).

Properties

Name Type Description
categoryxsd:string

A category of events.
description*xsd:string

A string that is a short human-parseable description of the event.

This is not the full message string (which may contain details of the arguments, etc.), but merely a more understandable, and localized, description of what the event stands for. It is meant for contexts where the name of the event has to be displayed to end-users, e.g. when creating Event-based Alarms. ` *

E.g., for VmPoweredOnEvent, the eventDescription in English might say "VM Powered On".

Since vSphere API 4.0
formatOnComputeResourcexsd:string

A string that is appropriate in the context of a specific cluster. For example, a powering on event in this context produces the following string:

"{vm.name} on {host.name} is powered on".

formatOnDatacenterxsd:string

A string that is appropriate in the context of a specific Datacenter. For example, a renaming event in this context produces the following string:

"Renamed {vm.name} from {oldName} to {newName}"

where oldName and newName are properties of the VmRenamedEvent object.

formatOnHostxsd:string

A string that is appropriate in the context of a specific Host. For example, a powering on event in this context produces the following string:

"{vm.name} is powered on"

formatOnVmxsd:string

A string that is appropriate for the context of a specific virtual machine. For example, a powering on event in this context produces the following string:

"Virtual machine on {host.name} is powered on"

fullFormatxsd:string

A string whose context is not entity-specific. For example, a powering on event produces the following string:

"{vm.name} on {host.name} in {datacenter.name} is powered on"

keyxsd:string

Type of event being described.
Properties inherited from DynamicData
dynamicProperty, dynamicType
*Need not be set
Show WSDL type definition