Struct k8s_openapi::api::resource::v1alpha3::ResourceClaimStatus

pub struct ResourceClaimStatus {
    pub allocation: Option<AllocationResult>,
    pub deallocation_requested: Option<bool>,
    pub reserved_for: Option<Vec<ResourceClaimConsumerReference>>,
}

ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.

Fields

allocation: Option<AllocationResult>

Allocation is set once the claim has been allocated successfully.

deallocation_requested: Option<bool>

Indicates that a claim is to be deallocated. While this is set, no new consumers may be added to ReservedFor.

This is only used if the claim needs to be deallocated by a DRA driver. That driver then must deallocate this claim and reset the field together with clearing the Allocation field.

This is an alpha field and requires enabling the DRAControlPlaneController feature gate.

reserved_for: Option<Vec<ResourceClaimConsumerReference>>

ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or might be in use because it has been reserved must not get deallocated.

In a cluster with multiple scheduler instances, two pods might get scheduled concurrently by different schedulers. When they reference the same ResourceClaim which already has reached its maximum number of consumers, only one pod can be scheduled.

Both schedulers try to add their pod to the claim.status.reservedFor field, but only the update that reaches the API server first gets stored. The other one fails with an error and the scheduler which issued it knows that it must put the pod back into the queue, waiting for the ResourceClaim to become usable again.

There can be at most 32 such reservations. This may get increased in the future, but not reduced.

Trait Implementations

impl Clone for ResourceClaimStatus

fn clone(&self) -> ResourceClaimStatus

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ResourceClaimStatus

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl DeepMerge for ResourceClaimStatus

fn merge_from(&mut self, other: Self)

Merge other into self.

impl Default for ResourceClaimStatus

fn default() -> ResourceClaimStatus

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ResourceClaimStatus

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ResourceClaimStatus

fn eq(&self, other: &ResourceClaimStatus) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ResourceClaimStatus

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ResourceClaimStatus