DeviceCapacity

io.k8s.api.resource.v1beta2.DeviceCapacity source ↗

DeviceCapacity describes a quantity associated with a device.

requestPolicyCapacityRequestPolicyRequestPolicy defines how this DeviceCapacity must be consumed when the device is allowed to be shared by multiple allocations.The Device must have allowMultipleAllocations set to true in order to set a requestPolicy.If unset, capacity requests are unconstrained: requests can consume any amount of capacity, as long as the total consumed across all allocations does not exceed the device's defined capacity. If request is also unset, default is the full capacity value.

defaultQuantityDefault specifies how much of this capacity is consumed by a request that does not contain an entry for it in DeviceRequest's Capacity.

validRangeCapacityRequestPolicyRangeValidRange defines an acceptable quantity value range in consuming requests.If this field is set, Default must be defined and it must fall within the defined ValidRange.If the requested amount does not fall within the defined range, the request violates the policy, and this device cannot be allocated.If the request doesn't contain this capacity entry, Default value is used.

maxQuantityMax defines the upper limit for capacity that can be requested.Max must be less than or equal to the capacity value. Min and requestPolicy.default must be less than or equal to the maximum.

minQuantity requiredMin specifies the minimum capacity allowed for a consumption request.Min must be greater than or equal to zero, and less than or equal to the capacity value. requestPolicy.default must be more than or equal to the minimum.

stepQuantityStep defines the step size between valid capacity amounts within the range.Max (if set) and requestPolicy.default must be a multiple of Step. Min + Step must be less than or equal to the capacity value.

validValues[]QuantityValidValues defines a set of acceptable quantity values in consuming requests.Must not contain more than 10 entries. Must be sorted in ascending order.If this field is set, Default must be defined and it must be included in ValidValues list.If the requested amount does not match any valid value but smaller than some valid values, the scheduler calculates the smallest valid value that is greater than or equal to the request. That is: min(ceil(requestedValue) ∈ validValues), where requestedValue ≤ max(validValues).If the requested amount exceeds all valid values, the request violates the policy, and this device cannot be allocated.

valueQuantity requiredValue defines how much of a certain capacity that device has.This field reflects the fixed total capacity and does not change. The consumed amount is tracked separately by scheduler and does not affect this value.