BlockModelRMO::Query Resource Allocations

Returns all allocations between a resource instance and a set of consumers. Used by Microsoft Provisioning Framework (MPF).

Arguments

The following table describes the XML schema elements and attributes. Unless otherwise indicated, the data type is string.

Element	Description, relationships, and attributes
actualUsed	Description: Actual resource capacity allocated to the consumer. Parent: consumerInstance
allocations	Description: List of allocations. Parent: executeData Child: consumerInstance (minOccurs="0" maxOccurs="*")
candidates	Description: Encapsulates data needed to describe the candidate set for consumer instances. If the candidate set is omitted, all allocations associated with the resource instance are returned. Parent: executeData Child: consumerTargetSet (minOccurs="0" maxOccurs="1")
consumerInstance	Description: Encapsulates data needed to describe a consumer instance. Parent: executeData Children: actualUsed (minOccurs="1" maxOccurs="1") instanceName (minOccurs="1" maxOccurs="1") typeName (minOccurs="1" maxOccurs="1") virtualUsed (minOccurs="1" maxOccurs="1")
consumerTargetSet	Description: Set of consumers to query. Parent: candidates
executeData	Description: Encapsulates the procedure's input and output data. Children: allocations (minOccurs="0" maxOccurs="1") resourceInstance (minOccurs="1" maxOccurs="1")
instanceLocation	Description: Location of the resource instance. Parent: resourceInstance
instanceName	Description: Name of the instance. Parents: consumerInstance (input), resourceInstance (output)
resourceInstance	Description: Encapsulates data required to describe a resource instance. Parent: allocations Children: instanceLocation (minOccurs="1" maxOccurs="1") instanceName (minOccurs="1" maxOccurs="1") typeName (minOccurs="1" maxOccurs="1")
typeName	Description: Name of the type associated with this instance. Parents: resourceInstance (input), consumerInstance (output)
virtualUsed	Description: Virtual resource capacity allocated to the consumer. Parent: consumerInstance
resourceInstance	Description: Encapsulates data required to describe a resource instance. Parent: executeData Children: instanceLocation (minOccurs="1" maxOccurs="1") instanceName (minOccurs="1" maxOccurs="1") typeName (minOccurs="1" maxOccurs="1")

Remarks

Schema Definition

Input

<executeData>1..1
  <resourceInstance>1..1
	<instanceName>1..1</instanceName>
	<typeName>1..1</typeName>
	<instanceLocation>1..1</instanceLocation>  
  </resourceInstance>
  <candidates>0..1
	<consumerTargetSet>0..1</consumerTargetSet>
  </candidates>
</executeData>

Output

<executeData>1..1
 <allocations>0..1
  <consumerInstance>0..unbounded
	<instanceName>1..1</instanceName>
	<typeName>1..1</typeName>
	<actualUsed>1..1</actualUsed>
	<virtualUsed>1..1</virtualUsed>
  </consumerInstance>
  </allocations>
</executeData>

Sample Code

Example XML Request

The following code fragment shows the format for sending data to this procedure. For more information on individual elements and attributes, see the Elements and Attributes table.

<request>
  <data/>
  <procedure>  
	<execute procedure="Query Resource Allocations" namespace="BlockModelRMO"> 
	<executeData>
		<resourceInstance>
		<instanceName>iis-1</instanceName>
		<typeName>IISServer</typeName>
		<instanceLocation>Lab A, Building B</instanceLocation>
		</resourceInstance>
	</executeData>
	<after source="executeData" sourcePath="allocations" destination="data" />
	</execute>
  </procedure>
</request>

Example XML Response

The following code fragment shows the format for sending data to this procedure. For more information on individual elements and attributes, see the Elements and Attributes table.

Applies To