Managed Object - PbmPlacementSolver(pbm.placement.PlacementSolver)

Property of: PbmServiceInstanceContent
See also: PbmCapabilityProfileCreateSpec, PbmPlacementCompatibilityResult, PbmPlacementHub, PbmProfileId

Managed Object Description

The PbmPlacementSolver data object provides methods to identify placement hubs that support the capabilities to store virtual machine files. A placement hub is a datastore or a storage pod. A vSphere API StoragePod corresponds to Storage DRS in the vSphere Web Client.

Properties

Name	Type	Description
None

Methods

Methods defined in this Managed Object
PbmCheckCompatibility, PbmCheckCompatibilityWithSpec, PbmQueryMatchingHub, PbmQueryMatchingHubWithSpec

PbmCheckCompatibility(checkCompatibility)

Performs placement compatibility checking based on a storage requirement profile. If compatibility checking for a hub does not produce any errors, the hub is considered a viable candidate for virtual machine file storage. If this method is invoked for VVolDefaultProfile profile, then all the vvol hubs are returned as matching.

Required Privileges: StorageProfile.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the PbmPlacementSolver used to make the method call.
hubsToSearch*	PbmPlacementHub[]	Candidate list of hubs, either datastores or storage pods or a mix. If you do not specify this parameter, the Server uses all of the datastores and storage pods for placement compatibility checking.
profile	PbmProfileId	Storage requirement profile.

*Need not be set

Return Value

Type Description

Type	Description
PbmPlacementCompatibilityResult[]	Array of compatibility result objects. The results array contains one entry for each entry in the `hubsToSearch` list. If you do not specify a hubs list, the results array contains one entry for each datastore and storage pod in your vSphere environment. Any errors are described in the results array. If there is an invalid argument error, the compatibility results will contain `InvalidArgument` faults indicating that the profile does not exist or that it does not match the requirement type. If there are errors or warnings during compatibility checking, the compatibility results will contain faults derived from PbmCompatibilityCheckFault. If this method is invoked for VVolDefaultProfile then the compatibility results will contain faults derived from PbmCompatibilityCheckFault for non-vvol datastores.

PbmPlacementCompatibilityResult[]

Array of compatibility result objects. The results array contains one entry for each entry in the hubsToSearch list. If you do not specify a hubs list, the results array contains one entry for each datastore and storage pod in your vSphere environment. Any errors are described in the results array.

If there is an invalid argument error, the compatibility results will contain InvalidArgument faults indicating that the profile does not exist or that it does not match the requirement type.
If there are errors or warnings during compatibility checking, the compatibility results will contain faults derived from PbmCompatibilityCheckFault.
If this method is invoked for VVolDefaultProfile then the compatibility results will contain faults derived from PbmCompatibilityCheckFault for non-vvol datastores.

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.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:pbm="urn:pbm" name="PbmCheckCompatibility" type="pbm:PbmCheckCompatibilityRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:pbm="urn:pbm" name="PbmCheckCompatibilityResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="pbm:PbmPlacementCompatibilityResult" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

PbmCheckCompatibilityWithSpec(checkCompatibilityWithSpec)

Performs placement compatibility checking based on a storage profile specification. If compatibility checking for a hub does not produce any errors, the hub is considered a viable candidate for virtual machine file storage.

Required Privileges: StorageProfile.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the PbmPlacementSolver used to make the method call.
hubsToSearch*	PbmPlacementHub[]	Candidate list of hubs, either datastores or storage pods or a mix. If you do not specify this parameter, the Server uses all of the datastores and storage pods for placement compatibility checking.
profileSpec	PbmCapabilityProfileCreateSpec	Specification for a capability based profile.

*Need not be set

Return Value

Type Description

Type	Description
PbmPlacementCompatibilityResult[]	Array of compatibility result objects. The results array contains one entry for each entry in the `hubsToSearch` list. If you do not specify a hubs list, the results array contains one entry for each datastore and storage pod in your vSphere environment. Any errors are described in the results array. If there is an invalid argument error, the compatibility results will contain `InvalidArgument` faults indicating that the profile does not exist or that it does not match the requirement type. If there are errors or warnings during compatibility checking, the compatibility results will contain faults derived from PbmCompatibilityCheckFault.

PbmPlacementCompatibilityResult[]

If there is an invalid argument error, the compatibility results will contain InvalidArgument faults indicating that the profile does not exist or that it does not match the requirement type.
If there are errors or warnings during compatibility checking, the compatibility results will contain faults derived from PbmCompatibilityCheckFault.

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.

Events

Type
None

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:pbm="urn:pbm" name="PbmCheckCompatibilityWithSpec" type="pbm:PbmCheckCompatibilityWithSpecRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:pbm="urn:pbm" name="PbmCheckCompatibilityWithSpecResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="pbm:PbmPlacementCompatibilityResult" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

PbmQueryMatchingHub(queryMatchingHub)

Finds matching placement hubs for the specified requirements profile. This method returns only those hubs that match the profile. If this method is invoked for VVolDefaultProfile profile, then all the vvol hubs are returned as matching.

Required Privileges: StorageProfile.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the PbmPlacementSolver used to make the method call.
hubsToSearch*	PbmPlacementHub[]	Candidate list of hubs, either datastores or storage pods or a mix. If you do not specify this parameter, the Server uses all of the datastores and storage pods.
profile	PbmProfileId	Storage requirement profile.

*Need not be set

Return Value

Type	Description
PbmPlacementHub[]	Subset of the `hubsToSearch` list that satisfies the profile requirements. A storage pod is returned if and only if all its member datastores satisfy the profile requirements, whether the hubs list contains any of the member datastores or not. If a datastore and its storage pod are in the hubs list, and both satisfy the requirements, both are returned.

Faults

Type	Description
PbmFault	Thrown if there is an internal server error.
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:pbm="urn:pbm" name="PbmQueryMatchingHub" type="pbm:PbmQueryMatchingHubRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:pbm="urn:pbm" name="PbmQueryMatchingHubResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="pbm:PbmPlacementHub" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

PbmQueryMatchingHubWithSpec(queryMatchingHubWithSpec)

Finds matching placement hubs based on a profile creation specification. This method returns only those hubs that match the specification.

Required Privileges: StorageProfile.View

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the PbmPlacementSolver used to make the method call.
hubsToSearch*	PbmPlacementHub[]	Candidate list of hubs, either datastores or storage pods or a mix. If you do not specify this parameter, the Server uses all of the datastores and storage pods for placement compatibility checking.
createSpec	PbmCapabilityProfileCreateSpec	Storage profile creation specification.

*Need not be set

Return Value

Type	Description
PbmPlacementHub[]	Subset of the `hubsToSearch` list that satisfies the profile requirements. A storage pod is returned if and only if all its member datastores satisfy the profile requirements, whether the hubs list contains any of the member datastores or not. If a datastore and its storage pod are in the hubs list, and both satisfy the requirements, both are returned.

Faults

Type	Description
PbmFault	Thrown if there is an internal server error.
RuntimeFault	Thrown 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

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:pbm="urn:pbm" name="PbmQueryMatchingHubWithSpec" type="pbm:PbmQueryMatchingHubWithSpecRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:pbm="urn:pbm" name="PbmQueryMatchingHubWithSpecResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="pbm:PbmPlacementHub" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>