ResourcePoolStatusRequest resource.k8s.io/v1alpha3

ResourcePoolStatusRequest triggers a one-time calculation of resource pool status based on the provided filters. Once status is set, the request is considered complete and will not be reprocessed. Users should delete and recreate requests to get updated information.

Fields

apiVersion: resource.k8s.io/v1alpha3
kind: ResourcePoolStatusRequest
metadata (ObjectMeta): Standard object metadata
spec (ResourcePoolStatusRequestSpec): Spec defines the filters for which pools to include in the status. The spec is immutable once created.
status (ResourcePoolStatusRequestStatus): Status is populated by the controller with the calculated pool status. When status is non-nil, the request is considered complete and the entire object becomes immutable.

ResourcePoolStatusRequestSpec

ResourcePoolStatusRequestSpec defines the filters for the pool status request.

driver (string)

Driver specifies the DRA driver name to filter pools. Only pools from ResourceSlices with this driver will be included. Must be a DNS subdomain (e.g., "gpu.example.com").

limit (integer)

Limit optionally specifies the maximum number of pools to return in the status. If more pools match the filter criteria, the response will be truncated (i.e., len(status.pools) < status.poolCount).

Default: 100 Minimum: 1 Maximum: 1000

poolName (string)

PoolName optionally filters to a specific pool name. If not specified, all pools from the specified driver are included. When specified, must be a non-empty valid resource pool name (DNS subdomains separated by "/").

ResourcePoolStatusRequestStatus

ResourcePoolStatusRequestStatus contains the calculated pool status information.

poolCount (integer)

PoolCount is the total number of pools that matched the filter criteria, regardless of truncation. This helps users understand how many pools exist even when the response is truncated. A value of 0 means no pools matched the filter criteria.

conditions ([]Condition)

Conditions provide information about the state of the request. A condition with type=Complete or type=Failed will always be set when the status is populated.

Known condition types: - "Complete": True when the request has been processed successfully - "Failed": True when the request could not be processed

pools ([]PoolStatus)

Pools contains the first spec.limit matching pools, sorted by driver then pool name. If len(pools) < poolCount, the list was truncated. When omitted, no pools matched the request filters.

PoolStatus contains status information for a single resource pool.

pools.driver (string): Driver is the DRA driver name for this pool. Must be a DNS subdomain (e.g., "gpu.example.com").
pools.generation (integer): Generation is the pool generation observed across all ResourceSlices in this pool. Only the latest generation is reported. During a generation rollout, if not all slices at the latest generation have been published, the pool is included with a validationError and device counts unset.
pools.poolName (string): PoolName is the name of the pool. Must be a valid resource pool name (DNS subdomains separated by "/").
pools.allocatedDevices (integer): AllocatedDevices is the number of devices currently allocated to claims. A value of 0 means no devices are allocated. May be unset when validationError is set.
pools.availableDevices (integer): AvailableDevices is the number of devices available for allocation. This equals TotalDevices - AllocatedDevices - UnavailableDevices. A value of 0 means no devices are currently available. May be unset when validationError is set.
pools.nodeName (string): NodeName is the node this pool is associated with. When omitted, the pool is not associated with a specific node. Must be a valid DNS subdomain name (RFC1123).
pools.resourceSliceCount (integer): ResourceSliceCount is the number of ResourceSlices that make up this pool. May be unset when validationError is set.
pools.totalDevices (integer): TotalDevices is the total number of devices in the pool across all slices. A value of 0 means the pool has no devices. May be unset when validationError is set.
pools.unavailableDevices (integer): UnavailableDevices is the number of devices that are not available due to taints or other conditions, but are not allocated. A value of 0 means all unallocated devices are available. May be unset when validationError is set.
pools.validationError (string): ValidationError is set when the pool's data could not be fully validated (e.g., incomplete slice publication). When set, device count fields and ResourceSliceCount may be unset.

ResourcePoolStatusRequestList

ResourcePoolStatusRequestList is a collection of ResourcePoolStatusRequests.

apiVersion: resource.k8s.io/v1alpha3
kind: ResourcePoolStatusRequestList
metadata (ListMeta): Standard list metadata
items ([]ResourcePoolStatusRequest): Items is the list of ResourcePoolStatusRequests.