com.pulumi.kubernetes.resource.v1beta1.outputs.ResourceClaimStatusPatch Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of kubernetes Show documentation
A Pulumi package for creating and managing Kubernetes resources.
The newest version!
// *** WARNING: this file was generated by pulumi-java-gen. ***
// *** Do not edit by hand unless you're certain you know what you are doing! ***

package com.pulumi.kubernetes.resource.v1beta1.outputs;

import com.pulumi.core.annotations.CustomType;
import com.pulumi.kubernetes.resource.v1beta1.outputs.AllocatedDeviceStatusPatch;
import com.pulumi.kubernetes.resource.v1beta1.outputs.AllocationResultPatch;
import com.pulumi.kubernetes.resource.v1beta1.outputs.ResourceClaimConsumerReferencePatch;
import java.util.List;
import java.util.Objects;
import java.util.Optional;
import javax.annotation.Nullable;

@CustomType
public final class ResourceClaimStatusPatch {
    /**
     * @return Allocation is set once the claim has been allocated successfully.
     * 
     */
    private @Nullable AllocationResultPatch allocation;
    /**
     * @return Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.
     * 
     */
    private @Nullable List devices;
    /**
     * @return 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.
     * 
     */
    private @Nullable List reservedFor;

    private ResourceClaimStatusPatch() {}
    /**
     * @return Allocation is set once the claim has been allocated successfully.
     * 
     */
    public Optional allocation() {
        return Optional.ofNullable(this.allocation);
    }
    /**
     * @return Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.
     * 
     */
    public List devices() {
        return this.devices == null ? List.of() : this.devices;
    }
    /**
     * @return 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.
     * 
     */
    public List reservedFor() {
        return this.reservedFor == null ? List.of() : this.reservedFor;
    }

    public static Builder builder() {
        return new Builder();
    }

    public static Builder builder(ResourceClaimStatusPatch defaults) {
        return new Builder(defaults);
    }
    @CustomType.Builder
    public static final class Builder {
        private @Nullable AllocationResultPatch allocation;
        private @Nullable List devices;
        private @Nullable List reservedFor;
        public Builder() {}
        public Builder(ResourceClaimStatusPatch defaults) {
    	      Objects.requireNonNull(defaults);
    	      this.allocation = defaults.allocation;
    	      this.devices = defaults.devices;
    	      this.reservedFor = defaults.reservedFor;
        }

        @CustomType.Setter
        public Builder allocation(@Nullable AllocationResultPatch allocation) {

            this.allocation = allocation;
            return this;
        }
        @CustomType.Setter
        public Builder devices(@Nullable List devices) {

            this.devices = devices;
            return this;
        }
        public Builder devices(AllocatedDeviceStatusPatch... devices) {
            return devices(List.of(devices));
        }
        @CustomType.Setter
        public Builder reservedFor(@Nullable List reservedFor) {

            this.reservedFor = reservedFor;
            return this;
        }
        public Builder reservedFor(ResourceClaimConsumerReferencePatch... reservedFor) {
            return reservedFor(List.of(reservedFor));
        }
        public ResourceClaimStatusPatch build() {
            final var _resultValue = new ResourceClaimStatusPatch();
            _resultValue.allocation = allocation;
            _resultValue.devices = devices;
            _resultValue.reservedFor = reservedFor;
            return _resultValue;
        }
    }
}