Managed Object - PbmComplianceManager(pbm.compliance.ComplianceManager)

Property of
PbmServiceInstanceContent
See also
PbmComplianceResult, PbmProfileId, PbmRollupComplianceResult, PbmServerObjectRef


Managed Object Description

The PbmComplianceManager provides methods to verify the compliance of virtual machine and virtual disk requirement profiles. When you provision a virtual machine on a matching datastore, the Server sends the profile to the storage provider. When you perform a compliance check, the storage provider compares the requirements with its capabilities, returns the results to the Server, and the Server returns the results to your client. The Server maintains the compliance results for retrieval at a later time.

You can check the compliance of one or more virtual machines and/or virtual disks. You can also perform a rollup compliance check, in which the Server checks the compliance of a virtual machine and all of its virtual disks.

Properties

Name Type Description
None

Methods

Methods defined in this Managed Object
PbmCheckCompliance, PbmCheckRollupCompliance, PbmFetchComplianceResult, PbmFetchRollupComplianceResult, PbmQueryByRollupComplianceStatus

PbmCheckCompliance(checkCompliance)

Checks compliance of the profiles associated with one or more virtual machines and/or virtual disks.

The Server stores the compliance results for all of the storage entities associated with the virtual machines and disks. You can call the PbmFetchComplianceResult method to retrieve the stored results.

Required Privileges
StorageProfile.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the PbmComplianceManager used to make the method call.
entitiesPbmServerObjectRef[]

One or more references to storage entities. You can specify virtual machines and virtual disks.
  • If the list of entities also contains datastores, the Server will ignore the datastores.
  • If the list contains valid and invalid entities, the Server ignores the invalid entities and returns results for the valid entities. Invalid entities are entities that are not in the vCenter inventory.
  • If the list contains only datastores, the method throws an InvalidArgument fault.
  • If the list contains virtual machines and disks and the entities are invalid or have been deleted by the time of the request, the method throws an InvalidArgument fault.

If an entity does not have an associated storage profile, the entity is removed from the list.

profile*PbmProfileId

Not used. If specified, the Server ignores the value. The Server uses the profiles associated with the specified entities.
*Need not be set

Return Value

Type Description
PbmComplianceResult[]Result of the compliance check. The returned array contains one result object for each entity specified in the method call.

Faults

Type Description
InvalidArgumentThrown if one of the following situations occurs:
  • You do not specify an entity.
  • You specify only datastores.
  • All of the specified storage entities are invalid.
PbmFaultThrown if there is an internal server error.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



PbmCheckRollupCompliance(checkRollupCompliance)

Checks rollup compliance of virtual machines and returns the results to your client. For a specified virtual machine, a rollup compliance check verifies the storage requirements of the virtual machine and its virtual disks as compared with the storage provider capabilities.

The Server stores the compliance results for all of the storage entities associated with the virtual machines. You can call the PbmFetchRollupComplianceResult method to retrieve the stored results.

Required Privileges
StorageProfile.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the PbmComplianceManager used to make the method call.
entityPbmServerObjectRef[]

One or more references to virtual machines.

Return Value

Type Description
PbmRollupComplianceResult[]Result of the rollup compliance check. The returned array contains one rollup compliance result for each virtual machine. A rollup compliance result object includes the overall compliance status that represents the collective compliance status for the virtual machine and its virtual disks.

Faults

Type Description
InvalidArgumentThrown if one of the following situations occurs:
  • You do not specify any entities.
  • You specify only datastores or virtual disks.
  • All of the specified virtual machines are invalid.
PbmFaultThrown if there is an internal server error.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



PbmFetchComplianceResult(fetchComplianceResult)

Retrieves the latest version of PbmComplianceResult objects that are available for the specified entities.
Required Privileges
StorageProfile.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the PbmComplianceManager used to make the method call.
entitiesPbmServerObjectRef[]

One or more references to storage entities. You can specify virtual machines and/or virtual disks.
  • If the list of entities also contains datastores, the Server will ignore the datastores.
  • If the list contains valid and invalid entities, the Server ignores the invalid entities and returns results for the valid entities. Invalid entities are entities that are not in the vCenter inventory.
  • If the list contains only datastores, the method throws an InvalidArgument fault.

profile*PbmProfileId

Not used. if specified, the Server ignores the value. The Server uses the profiles associated with the specified entities.
*Need not be set

Return Value

Type Description
PbmComplianceResult[]Array of compliance results. The returned array contains one result object for each entity specified in the method call.

Faults

Type Description
InvalidArgumentThrown if one of the following situations occurs:
  • You do not specify an entity.
  • You specify only datastores.
  • All of the specified storage entities are invalid.
PbmFaultThrown if there is an internal server error.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



PbmFetchRollupComplianceResult(fetchRollupComplianceResult)

Retrieves the rollup compliance (PbmRollupComplianceResult) of the given virtual machines if present. The returned rollup compliance result may be old. Invoke checkRollupCompliance API to compute & retrieve the latest rollup compliance result.
Required Privileges
StorageProfile.View

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the PbmComplianceManager used to make the method call.
entityPbmServerObjectRef[]

One or more virtual machines.

Return Value

Type Description
PbmRollupComplianceResult[]Rollup compliance results for the given virtual machines.

Faults

Type Description
InvalidArgumentThrown if one of the following situations occurs:
  • There is no profile associated with the virtual machine or its virtual disks.
  • You specify only datastores or virtual disks.
  • All of the specified virtual machines are invalid.
PbmFaultThrown if there is an internal server error.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



PbmQueryByRollupComplianceStatus(queryByRollupComplianceStatus)

Returns the virtual machines for the given rollup compliance status.
Required Privileges
StorageProfile.View
Since
6.5

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the PbmComplianceManager used to make the method call.
statusxsd:string

PbmComplianceStatus

Return Value

Type Description
PbmServerObjectRef[]Array of VirtualMachine entities

Faults

Type Description
InvalidArgumentThrown if the given status parameter is invalid or incorrect format.
PbmFaultThrown if there is an internal service error.
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition