BlockModelRMO::Add Resource Type Data

Adds block-model allocation data for a resource type. Used by Microsoft Provisioning Framework (MPF).

XML Input Schema

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.


<executeData>1..1 <resourceType>1..1 <typeName>1..1</typeName> <unit>1..1</unit> <virtualDataName>0..1</virtualDataName> <actualDataName>0..1</actualDataName> <actualDataDesc>0..1</actualDataDesc> <virtualDataDesc>0..1</virtualDataDesc> <defaultActualMax>0..1</defaultActualMax> <defaultVirtualMax>0..1</defaultVirtualMax> <defaultWarningPc>0..1</defaulWarningPc> <defaultMaxFillPc>0..1</defaultMaxFillPc> <defaultFillRatio>0..1</defaultFillRatio> </resourceType> </executeData>

XML Output Schema

Add Resource Type Data does not return data.

Elements and Attributes

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

Element Description, relationships, and attributes
actualDataDesc Description:
Description of the actual capacity data.

Parent:
resourceType

actualDataName Description:
Name for the actual capacity data (for example, "MB on disk").

Parent:
resourceType

defaultActualMax Description:
Default value for maximum actual capacity data for new resource instances that do not have an actualMax value. Must be 0 or a positive integer; the default value is 2147483647 (maximum value for a 32-bit signed integer).

Parent:
resourceType

defaultFillRatio Description:
Default value for the fill ratio for new resource instances that do not have a fillRatio value. Must be 0 (default) or a positive integer.

Parent:
resourceType

defaultMaxFillPc Description:
Default value for maximum fill percentage level for new resource instances that do not have a maxFillPc value. Must be a positive integer greater than or equal to 0, or less than or equal to 100 (default).

Parent:
resourceType

defaultVirtualMax Description:
Default value for maximum virtual capacity for new resource instances that do not have a virtualMax value. Must be 0 or a positive integer; the default value is 2147483647 (maximum value for a 32-bit signed integer).

Parent:
resourceType

defaultWarningPc Description:
Default value for the warning percentage level for new resource instances that do not have a warningPc value. Must be a positive integer greater than or equal to 0, or less than or equal to 100; the default value is 80.

Parent:
resourceType

executeData Description:
Encapsulates the procedure's input data.

Child:
resourceType (minOccurs="1" maxOccurs="1")

resourceType Description:
Encapsulates the data needed to describe a resource type.

Parent:
executeData

Children:
actualDataDesc (minOccurs="0" maxOccurs="1")
actualDataName (minOccurs="0" maxOccurs="1")
defaultActualMax (minOccurs="0" maxOccurs="1")
defaultFillRatio (minOccurs="0" maxOccurs="1")
defaultMaxFillPc (minOccurs="0" maxOccurs="1")
defaultVirtualMax (minOccurs="0" maxOccurs="1")
defaultWarningPc (minOccurs="0" maxOccurs="1")
typename (minOccurs="1" maxOccurs="1")
unit (minOccurs="1" maxOccurs="1")
virtualDataDesc (minOccurs="0" maxOccurs="1")
virtualDataName (minOccurs="0" maxOccurs="1")

typeName Description:
Name of the resource type with which the resource model data will be associated.

Parent:
resourceType

unit Description:
Resource capacity unit to associate with instances of this type. Examples include "MB" and "Users".

Parent:
resourceType

virtualDataName Description:
Name for the virtual capacity data (for example, "MB on user's plan").

Parent:
resourceType

virtualDataDesc Description:
Description of the virtual capacity data.

Parent:
resourceType

Example
<request>
  <data/>
  <procedure>  
	<execute procedure="Add Resource Type Data" namespace="BlockModelRMO"> 
	<executeData>
		<resourceType>
		<typeName>IISServer</typeName>
		<unit>Web Sites allocated</unit>
		<actualDataName>Web Sites allocated</actualDataName>
		<actualDataDesc>Number of Web Sites allocated on this server</actualDataDesc>
		<defaultActualMax>1000</defaultActualMax>
		<defaultWarningPc>80</defaultWarningPc>
		<defaultMaxFillPc>90</defaultMaxFillPc>
		</resourceType>
	</executeData>
	</execute>
  </procedure>
</request>
Remarks

This function will fail if the type does not exist, if type data has already been associated with this type, or if the data fails validation constraints.

See Also

Query Resource Data TypeBlockModelRMO Provider, Query Resource Capacity Data, Resource Manager, Update Resource Capacity Data