ResourcePoolStatusRequest

ResourcePoolStatusRequest запускает однократный расчёт состояния пула ресурсов на основе предоставленных фильтров. После установки состояния запрос считается завершённым и повторно обрабатываться не будет. Чтобы получить обновлённую информацию, пользователям следует удалить запрос и создать его заново.

Документация по концепции ResourcePoolStatusRequest

Динамическое выделение ресурсов

apiVersion: resource.k8s.io/v1alpha3

import "k8s.io/api/resource/v1alpha3"

ResourcePoolStatusRequest

Поле	Описание
`apiVersion` string	APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind` string	Kind — это строковое значение, представляющее ресурс REST, который описывает этот объект. Серверы могут определять его по конечной точке, на которую клиент отправляет запросы. Изменение не допускается. Используется стиль CamelCase. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata` * ObjectMeta	Стандартные метаданные объекта
`spec` * ResourcePoolStatusRequestSpec	Spec определяет фильтры для пулов, которые нужно включить в состояние. После создания спецификация не изменяется.
`status` ResourcePoolStatusRequestStatus	Status заполняется контроллером вычисленным состоянием пулов. Если status не равен nil, запрос считается завершённым, а весь объект становится неизменяемым.

ResourcePoolStatusRequestSpec

ResourcePoolStatusRequestSpec определяет фильтры для запроса состояния пулов.

Поле	Описание
`driver` * string	Driver задаёт имя драйвера DRA для фильтрации пулов. Будут включены только пулы из ResourceSlices с этим драйвером. Должно быть DNS-поддоменом (например, "gpu.example.com").
`limit` integer	Limit необязательно задаёт максимальное количество пулов, возвращаемых в состоянии. Если фильтру соответствуют дополнительные пулы, ответ будет усечён (то есть len(status.pools) \< status.poolCount). Значение по умолчанию: 100 Минимум: 1 Максимум: 1000
`poolName` string	PoolName необязательно фильтрует пулы по указанному имени. Если параметр не задан, включаются все пулы указанного драйвера. Если параметр задан, значение должно быть непустым допустимым именем пула ресурсов (DNS-поддомены, разделённые символом "/").

ResourcePoolStatusRequestStatus

ResourcePoolStatusRequestStatus содержит вычисленные сведения о состоянии пулов.

Поле	Описание
`conditions` Массив условий стратегия исправления: слияние по ключу `type`	Conditions содержат сведения о состоянии запроса. При заполнении status всегда устанавливается условие с типом Complete или Failed. Известные типы условий: - "Complete": True, если запрос успешно обработан - "Failed": True, если запрос не удалось обработать
`poolCount` * integer	PoolCount — общее количество пулов, соответствующих критериям фильтрации, независимо от усечения. Это позволяет пользователям узнать, сколько существует пулов, даже если ответ усечён. Значение 0 означает, что критериям фильтрации не соответствует ни один пул.
`pools` Массив PoolStatus	Pools содержит первые spec.limit пулов, соответствующих фильтру, отсортированных по драйверу, а затем по имени пула. Если len(pools) \< poolCount, список был усечён. Если поле отсутствует, ни один пул не соответствует фильтрам запроса.

ResourcePoolStatusRequestList

ResourcePoolStatusRequestList — это коллекция ResourcePoolStatusRequests.

Поле	Описание
`apiVersion` string	APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`items` * Массив ResourcePoolStatusRequest	Items — это список ResourcePoolStatusRequests.
`kind` string	Kind — это строковое значение, представляющее ресурс REST, который описывает этот объект. Серверы могут определять его по конечной точке, на которую клиент отправляет запросы. Изменение не допускается. Используется стиль CamelCase. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata` ListMeta	Стандартные метаданные списка

PoolStatus

PoolStatus содержит сведения о состоянии одного пула ресурсов.

Поле	Описание
`allocatedDevices` integer	AllocatedDevices — количество устройств, выделенных требованиям в данный момент. Значение 0 означает, что устройства не выделены. Может быть не задано, если установлено validationError.
`availableDevices` integer	AvailableDevices — количество устройств, доступных для выделения. Оно равно TotalDevices - AllocatedDevices - UnavailableDevices. Значение 0 означает, что в данный момент доступных устройств нет. Может быть не задано, если установлено validationError.
`driver` * string	Driver — имя драйвера DRA для этого пула. Должно быть DNS-поддоменом (например, "gpu.example.com").
`generation` * integer	Generation — поколение пула, обнаруженное во всех ResourceSlices этого пула. Указывается только последнее поколение. Во время развёртывания нового поколения, если ещё опубликованы не все срезы последнего поколения, пул включается с validationError, а количество устройств не указывается.
`nodeName` string	NodeName — узел, с которым связан этот пул. Если поле не задано, пул не связан с конкретным узлом. Должно быть допустимым именем DNS-поддомена (RFC1123).
`poolName` * string	PoolName — имя пула. Должно быть допустимым именем пула ресурсов (DNS-поддомены, разделённые символом "/").
`resourceSliceCount` integer	ResourceSliceCount — количество ResourceSlices, составляющих этот пул. Может быть не задано, если установлено validationError.
`totalDevices` integer	TotalDevices — общее количество устройств в пуле во всех срезах. Значение 0 означает, что в пуле нет устройств. Может быть не задано, если установлено validationError.
`unavailableDevices` integer	UnavailableDevices — количество устройств, недоступных из-за taints или других условий, но не выделенных. Значение 0 означает, что все невыделенные устройства доступны. Может быть не задано, если установлено validationError.
`validationError` string	ValidationError устанавливается, если данные пула не удалось полностью проверить (например, из-за неполной публикации срезов). Если поле установлено, поля с количеством устройств и ResourceSliceCount могут быть не заданы.

© 2026 The Kubernetes Authors | Documentation Distributed under CC BY 4.0
Copyright © 2026 The Linux Foundation ®. All rights reserved.
https://kubernetes.io/docs/reference/kubernetes-api/resource/resource-pool-status-request-v1alpha3/