Managed Object - AlarmManager

Property of: ServiceContent
See also: Alarm, AlarmDescription, AlarmExpression, AlarmSpec, AlarmState, ManagedEntity

Managed Object Description

The alarm manager is a singleton object for managing alarms within a service instance.

Properties

Name	Type	Description
defaultExpression* P	AlarmExpression[]	The default setting for each alarm expression, used to populate the initial client wizard screen.
description P	AlarmDescription	The static descriptive strings used in alarms.

*May not be presentP Required privilege: System.View

Methods

Methods defined in this Managed Object
CreateAlarm, GetAlarm, GetAlarmState

CreateAlarm

Creates an alarm.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the AlarmManager used to make the method call.
entity P	ManagedObjectReference to a ManagedEntity	The entity with which the alarm is associated.
spec	AlarmSpec	The specification for the new alarm.

P Required privilege: Alarm.Create

Return Value

Type	Description
ManagedObjectReference to a Alarm	A reference to the Alarm object created by the operation.

Faults

Type	Description
DuplicateName	Thrown if an alarm with the name already exists.
InvalidArgument	Thrown if the specification is invalid.
InvalidName	Thrown if the alarm name is empty or too long.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" name="CreateAlarm">
            <complexType>
               <sequence>
                  <element name="_this" type="vim2:ManagedObjectReference"/>
                  <element name="entity" type="vim2:ManagedObjectReference"/>
                  <element name="spec" type="vim2:AlarmSpec"/>
               </sequence>
            </complexType>
         </element>
         <element xmlns="http://www.w3.org/2001/XMLSchema" name="CreateAlarmResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim2:ManagedObjectReference"/>
               </sequence>
            </complexType>
         </element>

GetAlarm

Available alarms defined on the entity. These alarms do not include any inherited alarms; that is, alarms associated with parent entities.

Required Privileges: System.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the AlarmManager used to make the method call.
entity*	ManagedObjectReference to a ManagedEntity	The entity. If not set, alarms are returned for all visible entities.

*Need not be set

Return Value

Type	Description
ManagedObjectReference[] to a Alarm[]	A reference to the Alarm objects returned by the operation.

Faults

Type	Description
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" name="GetAlarm">
            <complexType>
               <sequence>
                  <element name="_this" type="vim2:ManagedObjectReference"/>
                  <element name="entity" type="vim2:ManagedObjectReference" minOccurs="0"/>
               </sequence>
            </complexType>
         </element>
         <element xmlns="http://www.w3.org/2001/XMLSchema" name="GetAlarmResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim2:ManagedObjectReference" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

GetAlarmState

The state of instantiated alarms on the entity.

Required Privileges: None

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the AlarmManager used to make the method call.
entity P	ManagedObjectReference to a ManagedEntity	The entity.

P Required privilege: System.Read

Return Value

Type	Description
AlarmState[]	The state of instantiated alarms.

Faults

Type	Description
InvalidArgument	Thrown if the referenced entity is null.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" name="GetAlarmState">
            <complexType>
               <sequence>
                  <element name="_this" type="vim2:ManagedObjectReference"/>
                  <element name="entity" type="vim2:ManagedObjectReference"/>
               </sequence>
            </complexType>
         </element>
         <element xmlns="http://www.w3.org/2001/XMLSchema" name="GetAlarmStateResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vim2:AlarmState" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>