1 karl 1.1.2.2 // Copyright (c) 2009 DMTF. All rights reserved.
2 [Version ( "2.24.0" ),
3 UMLPackagePath ( "CIM::Core::Resource" ),
4 Description (
5 "The ResourceAllocationSettingData class represents settings "
6 "specifically related to an allocated resource that are outside "
7 "the scope of the CIM class typically used to represent the "
8 "resource itself. These settings include information specific "
9 "to the allocation that may not be visible to the consumer of "
10 "the resource itself. For example, a virtual processor may look "
11 "like a 2 ghz processor to the consumer (virtual computer "
12 "system), however the virtualization system may use "
13 "time-slicing to schedule the the virtual processor to only "
14 "allow it to use 1 ghz." )]
15 class CIM_ResourceAllocationSettingData : CIM_SettingData {
16
17 [Description (
18 "The type of resource this allocation setting represents." ),
19 ValueMap { "1", "2", "3", "4", "5", "6", "7", "8", "9", "10",
20 "11", "12", "13", "14", "15", "16", "17", "18", "19",
21 "20", "21", "22", "23", "24", "25", "26", "27", "28",
22 karl 1.1.2.2 "29", "30", "31", "32", "33", "..", "0x8000..0xFFFF" },
23 Values { "Other", "Computer System", "Processor", "Memory",
24 "IDE Controller", "Parallel SCSI HBA", "FC HBA",
25 "iSCSI HBA", "IB HCA", "Ethernet Adapter",
26 "Other Network Adapter", "I/O Slot", "I/O Device",
27 "Floppy Drive", "CD Drive", "DVD drive", "Disk Drive",
28 "Tape Drive", "Storage Extent", "Other storage device",
29 "Serial port", "Parallel port", "USB Controller",
30 "Graphics controller", "IEEE 1394 Controller",
31 "Partitionable Unit", "Base Partitionable Unit", "Power",
32 "Cooling Capacity", "Ethernet Switch Port",
33 "Logical Disk", "Storage Volume", "Ethernet Connection",
34 "DMTF reserved", "Vendor Reserved" },
35 ModelCorrespondence {
36 "CIM_ResourceAllocationSettingData.OtherResourceType",
37 "CIM_ResourceAllocationSettingData.ResourceSubType" }]
38 uint16 ResourceType;
39
40 [Description (
41 "A string that describes the resource type when a well "
42 "defined value is not available and ResourceType has the "
43 karl 1.1.2.2 "value \"Other\"." ),
44 ModelCorrespondence {
45 "CIM_ResourceAllocationSettingData.ResourceType" }]
46 string OtherResourceType;
47
48 [Description (
49 "A string describing an implementation specific sub-type "
50 "for this resource. For example, this may be used to "
51 "distinguish different models of the same resource "
52 "type.The property value shall conform to this format (in "
53 "ABNF): vs-type = dmtf-value / other-org-value / "
54 "legacy-value dmtf-value = \"DMTF:\" defining-org \":\" "
55 "org-vs-type org-value = defining-org \":\" org-vs-type\n"
56 "Where: dmtf-value: is a property value defined by DMTF "
57 "and is defined in the description of this property. "
58 "other-org-value: is a property value defined by a "
59 "business entity other than DMTF and is not defined in "
60 "the description of this property. legacy-value: is a "
61 "property value defined by a business entity other than "
62 "DMTF and is not defined in the description of this "
63 "property. These values are permitted but recommended to "
64 karl 1.1.2.2 "be deprecated over time. defining-org:\n"
65 "is an identifier for the business entity that defines "
66 "the virtual system type. It shall include a copyrighted, "
67 "trademarked, or otherwise unique name that is owned by "
68 "that business entity. It shall not be \"DMTF\" and shall "
69 "not contain a colon (:). org-vs-type:\n"
70 "is an identifier for the virtual system type within the "
71 "defining business entity. It shall be unique within the "
72 "defining-org. It may use any character allowed for CIM "
73 "strings, except for the following: U0000-U001F (Unicode "
74 "C0 controls) U0020 (space), note that the reason is that "
75 "OVF allows for multiple space-separated vs-type values "
76 "in this property. U007F (Unicode C0 controls) "
77 "U0080-U009F (Unicode C1 controls)\n"
78 "If there is a need to structure the value into segments, "
79 "the segments should be separated with a single colon (:).\n"
80 "The values of this property shall be processed case "
81 "sensitively. They are intended to be processed "
82 "programmatically (instead of being a display name) and "
83 "should be short.\n"
84 "The following DMTF values are defined: DMTF:unknown - "
85 karl 1.1.2.2 "the resource sub-type is unknown or cannot be determined\n"
86 "Developers should consult the relevant profile for "
87 "defined values." ),
88 ModelCorrespondence {
89 "CIM_ResourceAllocationSettingData.ResourceType" }]
90 string ResourceSubType;
91
92 [Description (
93 "This property specifies which ResourcePool the resource "
94 "is currently allocated from, or which ResourcePool the "
95 "resource will be allocated from when the allocation "
96 "occurs." ),
97 ModelCorrespondence { "CIM_ResourcePool.PoolId" }]
98 string PoolID;
99
100 [Description (
101 "Describes the consumers visibility to the allocated resource.\n"
102 "A value of \"Passed-Through\" indicates the underlying "
103 "or host resource is utilized and passed through to the "
104 "consumer, possibly using partitioning. At least one item "
105 "shall be present in the HostResource property. \n"
106 karl 1.1.2.2 "A value of \"Virtualized\" indicates the resource is "
107 "virtualized and may not map directly to an "
108 "underlying/host resource. Some implementations may "
109 "support specific assignment for virtualized resources, "
110 "in which case the host resource(s) are exposed using the "
111 "HostResource property. \n"
112 "A value of \"Not represented\" indicates a "
113 "representation of the resource does not exist within the "
114 "context of the resource consumer." ),
115 ValueMap { "0", "2", "3", "4", "..", "32767..65535" },
116 Values { "Unknown", "Passed-Through", "Virtualized",
117 "Not represented", "DMTF reserved", "Vendor Reserved" }]
118 uint16 ConsumerVisibility;
119
120 [Description (
121 "This property exposes specific assignment of resources. "
122 "Each non-null value of the HostResource property shall "
123 "be formated as a URI per RFC3986.\n"
124 "If this resource is modeled then a value should be a "
125 "WBEM URI (DSP0207). If the resource is not modeled then "
126 "see the appropriate profile. \n"
127 karl 1.1.2.2 "Profiles may further constrain the type of URI. A NULL "
128 "value or empty array requests the implementation decide "
129 "the kind of host resource.\n"
130 "If the virtual resource is mapped to more than "
131 "oneunderlying resource, this property may be left NULL.\n"
132 "If NULL, the DeviceAllocatedFromPool or "
133 "ResourceAllocationFromPool associations may be used to "
134 "determine the pool of host resources this virtual "
135 "resource may use. If specific assignment is utilized, "
136 "all underlying resources used by this virtual resource "
137 "should be listed.The kind of dependency is specified by "
138 "the ConsumerVisibility and the MappingBehavior "
139 "properties. Typically the array contains one item, "
140 "however multiple host resources may be specified. \n"
141 "A client may set the value(s) to indicate that the "
142 "requested virtual resource allocation be based on host "
143 "resources that are identified by element values." ),
144 ModelCorrespondence {
145 "CIM_ResourceAllocationSettingData.ConsumerVisibility",
146 "CIM_ResourceAllocationSettingData.MappingBehavior" }]
147 string HostResource[];
148 karl 1.1.2.2
149 [Description (
150 "This property specifies the units of allocation used by "
151 "the Reservation and Limit properties. For example, when "
152 "ResourceType=Processor, AllocationUnits may be set to "
153 "hertz*10^6 or percent. When ResourceType=Memory, "
154 "AllocationUnits may be set to bytes*10^3. \n"
155 "It is expected that profiles constrain the units that "
156 "apply in context of particular resource types.\n"
157 "The value of this property shall be a legal value of the "
158 "Programmatic Units qualifier as defined in Annex C.1 of "
159 "DSP0004 V2.5 or later." ),
160 ModelCorrespondence {
161 "CIM_ResourceAllocationSettingData.Reservation",
162 "CIM_ResourceAllocationSettingData.Limit" },
163 IsPUnit]
164 string AllocationUnits;
165
166 [Description (
167 "This property specifies the quantity of resources "
168 "presented to the consumer. For example, when "
169 karl 1.1.2.2 "ResourceType=Processor, this property would reflect the "
170 "number of discrete Processors presented to the virtual "
171 "computer system. When ResourceType=Memory, this property "
172 "could reflect the number of MB reported to the virtual "
173 "computer system.\n"
174 "The value of the VirtualQuantity property should be "
175 "expressed in units as defined by the value of the "
176 "VirtualQuantityUnits property." ),
177 ModelCorrespondence {
178 "CIM_ResourceAllocationSettingData.VirtualQuantityUnits" }]
179 uint64 VirtualQuantity;
180
181 [Description (
182 "This property specifies the amount of resource "
183 "guaranteed to be available for this allocation. On "
184 "system which support over-commitment of resources, this "
185 "value is typically used for admission control to prevent "
186 "an an allocation from being accepted thus preventing starvation.\n"
187 "The value of the Reservation property is expressed in "
188 "the unit specified by the value of the AllocationUnits "
189 "property." ),
190 karl 1.1.2.2 ModelCorrespondence {
191 "CIM_ResourceAllocationSettingData.AllocationUnits" }]
192 uint64 Reservation;
193
194 [Description (
195 "This property specifies the upper bound, or maximum "
196 "amount of resource that will be granted for this "
197 "allocation. For example, a system which supports memory "
198 "paging may support setting the Limit of a Memory "
199 "allocation below that of the VirtualQuantity, thus "
200 "forcing paging to occur for this allocation.\n"
201 "The value of the Limit property is expressed in the unit "
202 "specified by the value of the AllocationUnits property." ),
203 ModelCorrespondence {
204 "CIM_ResourceAllocationSettingData.AllocationUnits" }]
205 uint64 Limit;
206
207 [Description (
208 "This property specifies a relative priority for this "
209 "allocation in relation to other allocations from the "
210 "same ResourcePool. This property has no unit of measure, "
211 karl 1.1.2.2 "and is only relevant when compared to other allocations "
212 "vying for the same host resources." )]
213 uint32 Weight;
214
215 [Description (
216 "This property specifies if the resource will be "
217 "automatically allocated. For example when set to true, "
218 "when the consuming virtual computer system is powered "
219 "on, this resource would be allocated. A value of false "
220 "indicates the resource must be explicitly allocated. For "
221 "example, the setting may represent removable media "
222 "(cdrom, floppy, etc.) where at power on time, the media "
223 "is not present. An explicit operation is required to "
224 "allocate the resource." )]
225 boolean AutomaticAllocation;
226
227 [Description (
228 "This property specifies if the resource will be "
229 "automatically de-allocated. For example, when set to "
230 "true, when the consuming virtual computer system is "
231 "powered off, this resource would be de-allocated. When "
232 karl 1.1.2.2 "set to false, the resource will remain allocated and "
233 "must be explicitly de-allocated." )]
234 boolean AutomaticDeallocation;
235
236 [Description (
237 "The Parent of the resource. For example, a controller "
238 "for the current allocation" )]
239 string Parent;
240
241 [Description (
242 "The thing to which this resource is connected. For "
243 "example, a named network or switch port." )]
244 string Connection[];
245
246 [Description (
247 "The address of the resource. For example, the MAC "
248 "address of a Ethernet port." )]
249 string Address;
250
251 [Description (
252 "Specifies how this resource maps to underlying "
253 karl 1.1.2.2 "resourcesIf the HostResource array contains any entries, "
254 "this property reflects how the resource maps to those "
255 "specific resources." ),
256 ValueMap { "0", "2", "3", "4", "5", "..", "32767..65535" },
257 Values { "Unknown", "Not Supported", "Dedicated",
258 "Soft Affinity", "Hard Affinity", "DMTF Reserved",
259 "Vendor Reserved" }]
260 uint16 MappingBehavior;
261
262 [Description (
263 "Describes the address of this resource in the context of "
264 "the Parent. The Parent/AddressOnParent properties are "
265 "used to describe the controller relationship as well the "
266 "ordering of devices on a controller.For example, if the "
267 "parent is a PCI Controller, this property would specify "
268 "the PCI slot of this child device." )]
269 string AddressOnParent;
270
271 [Description (
272 "This property specifies the units used by the "
273 "VirtualQuantity property. For example\n"
274 karl 1.1.2.2 "- if ResourceType=Processor, the value of the "
275 "VirtualQuantityUnits property may be set to \"count\", "
276 "indicating that the value of the VirtualQuantity "
277 "property is expressed as a count.\n"
278 "- if ResourceType=Memory, the value of the "
279 "VirtualQuantityUnits property may be set to "
280 "\"bytes*10^3\", indicating that the value of the "
281 "VirtualQuantity property is expressed in kilobyte.\n"
282 "It is expected that profiles constrain the units that "
283 "apply in context of particular resource types.\n"
284 "The value of this property shall be a legal value of the "
285 "Programmatic Units qualifier as defined in Annex C.1 of "
286 "DSP0004 V2.5 or later." ),
287 ModelCorrespondence {
288 "CIM_ResourceAllocationSettingData.VirtualQuantity" },
289 IsPUnit]
290 string VirtualQuantityUnits = "count";
291
292
293 };
|
Return to
CIM_ResourceAllocationSettingData.mof
CVS log
Up to [Pegasus] / pegasus / Schemas / CIM231 / DMTF / Core