Managed Object - ProfileComplianceManager

Property of
ServiceContent
See also
ComplianceResult, ManagedEntity, Profile, ProfileExpressionMetadata
Since
vSphere API 4.0


Managed Object Description

Interface handling the Compliance aspects of entities.

Properties

Name Type Description
None

Methods

Methods defined in this Managed Object
CheckCompliance_Task, ClearComplianceStatus, QueryComplianceStatus, QueryExpressionMetadata

CheckCompliance_Task

Check compliance of an entity against a Profile.
Required Privileges
System.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the ProfileComplianceManager used to make the method call.
profile*ManagedObjectReference[]
to a Profile[]

If specified, check compliance against the specified profiles. If not specified, use the profiles associated with the entities. If both Profiles and Entities are specified, Check the compliance of each Entity against each of the profile specified.
For more information, look at the KMap below.
P represents if Profile is specified.
E represents if Entity is specified. 
            P                        ^P
  ---------------------------------------------------
  | Check compliance      |  Profiles associated    |
 E|  of each entity       |   with the specified    |
  |  against each of the  |   entity will be used   |
  |  profiles specified.  |   for checking          |
  |                       |   compliance.           |
  |                       |                         |
  |                       |                         |
  ---------------------------------------------------
  | All entities          |   InvalidArgument       |
  |  associated with the  |   Exception is thrown.  |
  |  profile are checked. |                         |
^E|                       |                         |
  |                       |                         |
  |                       |                         |
  |                       |                         |
  ---------------------------------------------------

entity*ManagedObjectReference[]
to a ManagedEntity[]

If specified, the compliance check is done against this entity.
*Need not be set

Return Value

Type Description
ManagedObjectReference
to a Task

Faults

Type Description
InvalidArgumentThrown if neither profile nor entity is specified.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.



ClearComplianceStatus

Clear the saved ComplianceResult based on profile and entity filtering criteria.
Required Privileges
Profile.Clear

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the ProfileComplianceManager used to make the method call.
profile*ManagedObjectReference[]
to a Profile[]

If specified, clear the ComplianceResult related to the Profile.
entity*ManagedObjectReference[]
to a ManagedEntity[]

If specified, clear the ComplianceResult related to the entity. If profile and entity are not specified, all the ComplianceResults will be cleared.
*Need not be set

Return Value

Type Description
None

Faults

Type Description
RuntimeFaultThrown 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



QueryComplianceStatus

Query the compliance status based on Profile and Entity filter.
Required Privileges
System.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the ProfileComplianceManager used to make the method call.
profile*ManagedObjectReference[]
to a Profile[]

If specified, compliance result for the specified profiles will be returned. This acts like a filtering criteria for the ComplianceResults based on specified profiles.
entity*ManagedObjectReference[]
to a ManagedEntity[]

If specified, compliance results for these entities will be returned. This acts like a filtering criteria for the ComplianceResults based on entities.
*Need not be set

Return Value

Type Description
ComplianceResult[]ComplianceResult. ComplianceResult information may not be available for all the entities. If the ComplianceResult is not available already, a new ComplianceCheck will not be triggered.

Faults

Type Description
InvalidArgumentThrown if neither profile nor entity is specified.
RuntimeFaultThrown 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



QueryExpressionMetadata

Query the metadata for the expressions.
Required Privileges
System.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the ProfileComplianceManager used to make the method call.
expressionName*xsd:string[]

Names of the Expressions for which metadata is requested. If expressionNames are not specified, metadata for all known expressions is returned
profile*ManagedObjectReference
to a Profile

Base profile whose context needs to be used during the operation

Since vSphere API 5.0
*Need not be set

Return Value

Type Description
ProfileExpressionMetadata[]

Faults

Type Description
InvalidArgumentThrown if expressionName is invalid.
RuntimeFaultThrown 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