ResourceClaim

ResourceClaim описывает запрос на доступ к ресурсам кластера для использования рабочими нагрузками. Например, если рабочей нагрузке требуется ускорительное устройство с определёнными свойствами, такой запрос выражается именно так. Раздел status отслеживает, был ли этот запрос удовлетворён и какие конкретные ресурсы были выделены.

apiVersion: resource.k8s.io/v1

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

ResourceClaim

Поле	Описание
`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` * ResourceClaimSpec	Spec описывает, что запрашивается и как это настроить. Spec неизменяем.
`status` ResourceClaimStatus	Status описывает, готов ли запрос к использованию и что было выделено.

ResourceClaimSpec

ResourceClaimSpec определяет, что запрашивается в ResourceClaim и как это настроить.

Поле	Описание
`devices` DeviceClaim	Devices определяет способ запроса устройств.

ResourceClaimStatus

ResourceClaimStatus отслеживает, было ли выделено запрошенное ресурсное обеспечение и каков результат выделения.

Поле	Описание
`allocation` AllocationResult	Allocation задаётся после успешного выделения ресурсов по запросу.
`devices` AllocatedDeviceStatus array	Devices содержит сведения о состоянии каждого устройства, выделенного для этого запроса, согласно данным драйвера. Они могут включать информацию, специфичную для драйвера. Записями владеют соответствующие драйверы.
`reservedFor` ResourceClaimConsumerReference array стратегия patch: объединение по ключу `uid`	ReservedFor указывает, каким сущностям в данный момент разрешено использовать запрос. Pod, ссылающийся на ResourceClaim, который не зарезервирован для этого Pod, не будет запущен. Запрос, который используется или может быть использован, поскольку он зарезервирован, нельзя деаллоцировать. В кластере с несколькими экземплярами планировщика два Pod могут быть запланированы одновременно разными планировщиками. Если они ссылаются на один и тот же ResourceClaim, который уже достиг максимального числа потребителей, запланирован может быть только один Pod. Оба планировщика пытаются добавить свой Pod в поле claim.status.reservedFor, но сохраняется только обновление, которое первым достигает API-сервера. Второе завершается ошибкой, и выдавший его планировщик знает, что должен вернуть Pod в очередь, ожидая, пока ResourceClaim снова станет доступен. Таких резервирований может быть не более 256. В будущем это число может быть увеличено, но не уменьшено.

ResourceClaimList

ResourceClaimList — это коллекция запросов.

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

AllocatedDeviceStatus

AllocatedDeviceStatus содержит сведения о состоянии выделенного устройства, если драйвер решил их предоставить. Они могут включать информацию, специфичную для драйвера.

Комбинация Driver, Pool, Device и ShareID должна соответствовать ключу в Status.Allocation.Devices.

Поле	Описание
`conditions` Condition array	Conditions содержит последнее наблюдение за состоянием устройства. Если устройство настроено в соответствии со ссылками на конфигурацию класса и запроса, условие `Ready` должно иметь значение True. Не более 8 записей.
`data`	Data содержит произвольные данные, специфичные для драйвера. Длина необработанных данных не должна превышать 10 Ki.
`device` * string	Device ссылается на экземпляр устройства по его имени в пуле ресурсов драйвера. Имя должно быть DNS-меткой.
`driver` * string	Driver указывает имя драйвера DRA, плагин kubelet которого следует вызвать для обработки выделения, когда запрос понадобится на узле. Имя должно быть DNS-поддоменом и должно оканчиваться DNS-доменом, принадлежащим поставщику драйвера. Следует использовать только строчные символы.
`networkData` NetworkDeviceData	NetworkData содержит сведения о сети, относящиеся к устройству.
`pool` * string	Это имя вместе с именем драйвера и полем имени устройства определяет, какое устройство было выделено (`\/\/\`). Длина не должна превышать 253 символа; имя может содержать один или несколько DNS-поддоменов, разделённых косой чертой.
`shareID` string	ShareID уникально идентифицирует отдельную долю выделения устройства.

AllocationResult

AllocationResult содержит атрибуты выделенного ресурса.

Поле	Описание
`allocationTimestamp` Time	AllocationTimestamp хранит время выделения ресурсов. Это поле не обязательно задаётся; в таком случае время неизвестно. Это поле бета-версии, для него необходимо включить функциональные переключатели DRADeviceBindingConditions и DRAResourceClaimDeviceStatus.
`devices` DeviceAllocationResult	Devices — результат выделения устройств.
`nodeSelector` NodeSelector	NodeSelector определяет, где доступны выделенные ресурсы. Если значение не задано, они доступны везде.

CapacityRequirements

CapacityRequirements определяет требования к ёмкости для конкретного запроса устройства.

Поле Описание

requests
object Requests представляет отдельные запросы ресурсов устройства для различных ресурсов, все из которых должны предоставляться устройством. Это значение используется как дополнительное условие фильтрации доступной ёмкости устройства. Семантически это эквивалентно селектору CEL `device.capacity[\].\.compareTo(quantity(\)) >= 0`. Например, device.capacity['test-driver.cdi.k8s.io'].counters.compareTo(quantity('2')) >= 0. Если задана requestPolicy, запрошенное значение округляется вверх до ближайшего допустимого значения в соответствии с этой политикой. Если запрос невозможно скорректировать до допустимого значения — например, если он превышает ограничения requestPolicy, — устройство считается непригодным для выделения. Для любой ёмкости, которая явно не запрошена: - если requestPolicy не задана, по умолчанию потребляется вся ёмкость устройства (то есть запрашивается всё устройство); - если requestPolicy задана, потребляемая по умолчанию ёмкость определяется этой политикой. Если устройство допускает множественное выделение, суммарное значение по всем запросам не должно превышать значение ёмкости. Потребляемая ёмкость, которая может быть скорректирована в соответствии с requestPolicy, если она задана, записывается в поле resource claim status.devices[*].consumedCapacity.

Поле	Описание
`requests` object	Requests представляет отдельные запросы ресурсов устройства для различных ресурсов, все из которых должны предоставляться устройством. Это значение используется как дополнительное условие фильтрации доступной ёмкости устройства. Семантически это эквивалентно селектору CEL `device.capacity[\].\.compareTo(quantity(\)) >= 0`. Например, device.capacity['test-driver.cdi.k8s.io'].counters.compareTo(quantity('2')) >= 0. Если задана requestPolicy, запрошенное значение округляется вверх до ближайшего допустимого значения в соответствии с этой политикой. Если запрос невозможно скорректировать до допустимого значения — например, если он превышает ограничения requestPolicy, — устройство считается непригодным для выделения. Для любой ёмкости, которая явно не запрошена: - если requestPolicy не задана, по умолчанию потребляется вся ёмкость устройства (то есть запрашивается всё устройство); - если requestPolicy задана, потребляемая по умолчанию ёмкость определяется этой политикой. Если устройство допускает множественное выделение, суммарное значение по всем запросам не должно превышать значение ёмкости. Потребляемая ёмкость, которая может быть скорректирована в соответствии с requestPolicy, если она задана, записывается в поле resource claim status.devices[*].consumedCapacity.

DeviceAllocationConfiguration

DeviceAllocationConfiguration включается в AllocationResult.

Поле	Описание
`opaque` OpaqueDeviceConfiguration	Opaque предоставляет параметры конфигурации, специфичные для драйвера.
`requests` string array	Requests содержит имена запросов, к которым применяется конфигурация. Если список пуст, она применяется ко всем запросам. Ссылки на подзапросы должны включать имя основного запроса и могут включать имя подзапроса в формате \ [/\]. Если указано только имя основного запроса, конфигурация применяется ко всем подзапросам.
`source` * string	Source указывает, поступает ли конфигурация из класса и поэтому не могла быть задана обычным пользователем, или из запроса. Возможные значения перечисления: - `"FromClaim"` - `"FromClass"`

DeviceAllocationResult

DeviceAllocationResult — результат выделения устройств.

Поле Описание

config
DeviceAllocationConfiguration array Это поле объединяет все параметры конфигурации запроса и класса. Драйверы могут различать их по флагу. Сюда входят параметры конфигурации драйверов, у которых нет выделенных устройств в результате, поскольку именно драйверы определяют, какие параметры конфигурации они поддерживают. Неизвестные параметры конфигурации можно молча игнорировать.

results
DeviceRequestAllocationResult array Results содержит список всех выделенных устройств.

Поле	Описание
`config` DeviceAllocationConfiguration array	Это поле объединяет все параметры конфигурации запроса и класса. Драйверы могут различать их по флагу. Сюда входят параметры конфигурации драйверов, у которых нет выделенных устройств в результате, поскольку именно драйверы определяют, какие параметры конфигурации они поддерживают. Неизвестные параметры конфигурации можно молча игнорировать.
`results` DeviceRequestAllocationResult array	Results содержит список всех выделенных устройств.

DeviceClaim

DeviceClaim определяет способ запроса устройств с помощью ResourceClaim.

Поле	Описание
`config` DeviceClaimConfiguration array	Это поле содержит конфигурацию для нескольких потенциальных драйверов, которые могут удовлетворить запросы в этом запросе ресурсов. При выделении ресурсов по запросу оно игнорируется.
`constraints` DeviceConstraint array	Эти ограничения должны выполняться для набора устройств, выделенных по запросу.
`requests` DeviceRequest array	Requests представляет отдельные запросы на различные устройства, каждый из которых должен быть удовлетворён. Если список пуст, выделять ничего не требуется.

DeviceClaimConfiguration

DeviceClaimConfiguration используется для задания параметров конфигурации в DeviceClaim.

Поле Описание

opaque
OpaqueDeviceConfiguration Opaque предоставляет параметры конфигурации, специфичные для драйвера.

requests
string array Requests содержит имена запросов, к которым применяется конфигурация. Если список пуст, она применяется ко всем запросам. Ссылки на подзапросы должны включать имя основного запроса и могут включать имя подзапроса в формате \
[/\]. Если указано только имя основного запроса, конфигурация применяется ко всем подзапросам.

DeviceConstraint

В DeviceConstraint должно быть задано ровно одно поле помимо Requests.

Поле	Описание
`distinctAttribute` string	DistinctAttribute требует, чтобы все рассматриваемые устройства имели этот атрибут, а его тип и значение были уникальными для этих устройств. Если включён функциональный переключатель DRAListTypeAttributes, сравнение выполняется с учётом семантики множеств (то есть порядок элементов и дубликаты игнорируются): значения атрибутов в виде списков должны быть попарно непересекающимися для разных устройств. Для обратной совместимости скалярные значения рассматриваются как одноэлементные множества. Это обратное условие для MatchAttribute. Ограничение позволяет избежать выделения нескольких запросов одному устройству, обеспечивая различие на уровне атрибутов. Это полезно в сценариях, где запросы ресурсов должны удовлетворяться разными физическими устройствами. Например, контейнер запрашивает два сетевых интерфейса, которые должны быть выделены с двух разных физических сетевых карт.
`matchAttribute` string	MatchAttribute требует, чтобы все рассматриваемые устройства имели этот атрибут с одинаковыми типом и значением. Например, если указать "dra.example.com/numa" (гипотетический пример!), будут выбраны только устройства в одном узле NUMA. Устройство без такого атрибута выбрано не будет. Для этого атрибута все устройства должны использовать значения одного типа, поскольку это предусмотрено его спецификацией. Если тип значения одного из устройств отличается, это устройство также не будет выбрано. Если включён функциональный переключатель DRAListTypeAttributes, сравнение выполняется с учётом семантики множеств (то есть порядок элементов и дубликаты игнорируются): значения атрибутов в виде списков совпадают, если пересечение списков всех устройств непустое. Для обратной совместимости скалярные значения рассматриваются как одноэлементные списки. Должен быть указан квалификатор домена.
`requests` string array	Requests — это список из одного или нескольких запросов в данном запросе ресурсов, которые должны совместно удовлетворять этому ограничению. Если запрос выполняется с помощью нескольких устройств, все устройства должны удовлетворять ограничению. Если значение не задано, ограничение применяется ко всем запросам в данном запросе ресурсов. Ссылки на подзапросы должны включать имя основного запроса и могут включать имя подзапроса в формате \ [/\]. Если указано только имя основного запроса, ограничение применяется ко всем подзапросам.

DeviceRequest

DeviceRequest — это запрос устройств, необходимых для запроса ресурсов. Обычно запрашивается один ресурс, например устройство, но также можно запросить несколько одинаковых устройств. С помощью FirstAvailable можно также указать упорядоченный по приоритету список запросов.

Поле	Описание
`exactly` ExactDeviceRequest	Exactly задаёт параметры отдельного запроса, которые должны быть выполнены в точности, чтобы запрос считался удовлетворённым. Должно быть задано одно из полей Exactly или FirstAvailable.
`firstAvailable` DeviceSubRequest array	FirstAvailable содержит подзапросы, из которых планировщик выберет ровно один. Планировщик пытается удовлетворить их в указанном здесь порядке. Поэтому, если в списке две записи, планировщик проверит вторую только в том случае, если решит, что первую использовать нельзя. DRA пока не реализует ранжирование, поэтому планировщик выберет первый набор устройств, удовлетворяющий всем запросам в запросе ресурсов. Если требования можно удовлетворить более чем на одном узле, выбор узла будет определяться другими функциями планирования. Это означает, что набор устройств, выделенный для запроса, может быть не оптимальным из доступных в кластере. Ранжирование будет реализовано позднее.
`name` * string	Name можно использовать для ссылки на этот запрос в записи pod.spec.containers[].resources.claims и в ограничении запроса ресурсов. Если задано поле Exactly, ссылка по имени из DeviceRequest однозначно определяет запрос. Если задано поле FirstAvailable, ссылка на имя DeviceRequest соответствует подзапросу, выбранному планировщиком. Имя должно быть DNS-меткой.

DeviceRequestAllocationResult

DeviceRequestAllocationResult содержит результат выделения для одного запроса.

Поле	Описание
`adminAccess` boolean	AdminAccess указывает, что устройство выделено для административного доступа. Определение режима см. в соответствующем поле запроса. Административный доступ отключён, если поле не задано или имеет значение false; в противном случае он включён.
`bindingConditions` string array	BindingConditions содержит копию BindingConditions из соответствующего ResourceSlice на момент выделения. Это поле бета-версии, для него необходимо включить функциональные переключатели DRADeviceBindingConditions и DRAResourceClaimDeviceStatus.
`bindingFailureConditions` string array	BindingFailureConditions содержит копию BindingFailureConditions из соответствующего ResourceSlice на момент выделения. Это поле бета-версии, для него необходимо включить функциональные переключатели DRADeviceBindingConditions и DRAResourceClaimDeviceStatus.
`consumedCapacity` object	ConsumedCapacity отслеживает объём ёмкости каждого устройства, потребляемый в рамках запроса. Потребляемое значение может отличаться от запрошенного: оно округляется вверх до ближайшего допустимого значения на основании requestPolicy устройства, если она применима (то есть не может быть меньше запрошенного значения). Суммарная потребляемая ёмкость каждого устройства не должна превышать значение DeviceCapacity. Это поле заполняется только для устройств, допускающих множественное выделение. Указываются все записи ёмкости, даже если потребляемое значение равно нулю.
`device` * string	Device ссылается на экземпляр устройства по его имени в пуле ресурсов драйвера. Имя должно быть DNS-меткой.
`driver` * string	Driver указывает имя драйвера DRA, плагин kubelet которого следует вызвать для обработки выделения, когда запрос понадобится на узле. Имя должно быть DNS-поддоменом и должно оканчиваться DNS-доменом, принадлежащим поставщику драйвера. Следует использовать только строчные символы.
`pool` * string	Это имя вместе с именем драйвера и полем имени устройства определяет, какое устройство было выделено (`\/\/\`). Длина не должна превышать 253 символа; имя может содержать один или несколько DNS-поддоменов, разделённых косой чертой.
`request` * string	Request — это имя запроса в запросе ресурсов, из-за которого было выделено это устройство. Если он ссылается на подзапрос в списке firstAvailable объекта DeviceRequest, это поле должно содержать имя основного запроса и подзапрос в формате \ /\. Для одного запроса могли быть выделены несколько устройств.
`shareID` string	ShareID уникально идентифицирует отдельную долю выделения устройства и используется, когда устройство поддерживает несколько одновременных выделений. Это дополнительный ключ карты, позволяющий различать одновременные доли одного устройства.
`tolerations` DeviceToleration array	Копия всех допусков, указанных в запросе на момент выделения устройства. Максимальное число допусков — 16. Это поле бета-версии, для него необходимо включить функциональный переключатель DRADeviceTaints.

DeviceSubRequest

DeviceSubRequest описывает запрос устройства, заданный в массиве claim.spec.devices.requests[].firstAvailable. Обычно каждый подзапрос запрашивает один ресурс, например устройство, но также может запрашивать несколько одинаковых устройств.

DeviceSubRequest похож на ExactDeviceRequest, но не содержит поля AdminAccess, поскольку оно поддерживается только при запросе конкретного устройства.

Поле	Описание
`allocationMode` string	AllocationMode и связанные с ним поля определяют способ выделения устройств для выполнения этого подзапроса. Поддерживаемые значения: - ExactCount: запрашивается конкретное число устройств. Это значение используется по умолчанию. Точное число указывается в поле count. - All: этот подзапрос запрашивает все подходящие устройства в пуле. Выделение завершится ошибкой, если некоторые устройства уже выделены, кроме случая, когда запрошен adminAccess. Если AllocationMode не задан, по умолчанию используется режим ExactCount. Если выбран режим ExactCount, а count не задан, по умолчанию используется значение один. Для любых других подзапросов это поле должно быть задано. В будущем могут добавиться другие режимы. Клиенты должны отказываться обрабатывать запросы с неизвестными режимами. Возможные значения перечисления: - `"All"` - `"ExactCount"`
`capacity` CapacityRequirements	Capacity определяет требования к ресурсам для каждой ёмкости. Если это поле не задано и устройство поддерживает множественное выделение, для каждой ёмкости будет применено значение по умолчанию в соответствии с requestPolicy. Для ёмкости без requestPolicy по умолчанию используется её полное значение. Применяется к каждому выделению устройства. Если Count > 1, запрос завершается ошибкой, если недостаточно устройств, удовлетворяющих требованиям. Если AllocationMode имеет значение All, запрос завершается ошибкой, если существуют устройства, которые в остальном соответствуют запросу и имеют эту ёмкость со значением >= запрошенного, но не могут быть выделены для этого запроса.
`count` integer	Count используется только в режиме подсчёта "ExactCount". Значение должно быть больше нуля. Если AllocationMode имеет значение ExactCount, а это поле не задано, по умолчанию используется значение один.
`deviceClassName` * string	DeviceClassName ссылается на конкретный DeviceClass, который может задавать дополнительную конфигурацию и селекторы, наследуемые этим подзапросом. Класс обязателен. Набор доступных классов зависит от кластера. Администраторы могут ограничить набор устройств, которые можно запрашивать, установив только классы с селекторами, разрешающими доступ к нужным устройствам. Если пользователям разрешено запрашивать любые устройства без ограничений, администраторы могут создать пустой DeviceClass, на который пользователи смогут ссылаться.
`name` * string	Name можно использовать для ссылки на этот подзапрос в списке ограничений или конфигураций запроса ресурсов. Ссылки должны использовать формат \ /\. Имя должно быть DNS-меткой.
`selectors` DeviceSelector array	Selectors определяет критерии, которым должно соответствовать конкретное устройство, чтобы его можно было рассматривать для этого подзапроса. Чтобы устройство считалось подходящим, должны выполняться все селекторы.
`tolerations` DeviceToleration array	Если задано, это допуски запроса. Для выделения устройства с taint, имеющим эффект NoSchedule, необходимы допуски с эффектом NoSchedule. То же относится к NoExecute. Кроме того, если после выделения на какое-либо выделенное устройство будет установлен taint NoExecute, а соответствующий эффект не будет допущен, все Pod, использующие ResourceClaim, будут удалены для их вытеснения. Планировщик не позволит новым Pod резервировать запрос, пока на этих устройствах есть taint. После вытеснения всех Pod запрос будет деаллоцирован. Максимальное число допусков — 16. Это поле бета-версии, для него необходимо включить функциональный переключатель DRADeviceTaints.

DeviceToleration

ResourceClaim, к которому добавлен этот DeviceToleration, допускает любой taint, соответствующий тройке <key,value,effect> с использованием указанного оператора <operator>.

Поле	Описание
`effect` string	Effect указывает эффект taint, которому нужно соответствовать. Пустое значение означает соответствие всем эффектам taint. Если значение задано, допустимы NoSchedule и NoExecute. Возможные значения перечисления: - `"NoExecute"` Вытеснять уже запущенные Pod, которые не допускают taint устройства. - `"NoSchedule"` Не разрешать планирование новых Pod, использующих устройство с taint, если они не допускают этот taint; при этом разрешать запуск всех Pod, переданных в Kubelet в обход планировщика, и продолжать выполнение всех уже запущенных Pod. - `"None"` Эффект отсутствует; taint носит исключительно информационный характер.
`key` string	Key — это ключ taint, к которому применяется допуск. Пустое значение означает соответствие всем ключам taint. Если ключ пуст, оператор должен иметь значение Exists; эта комбинация означает соответствие всем значениям и всем ключам. Должно быть допустимое имя метки.
`operator` string	Operator определяет отношение ключа к значению. Допустимые операторы — Exists и Equal. По умолчанию используется Equal. Exists эквивалентен подстановочному знаку для значения, поэтому ResourceClaim может допускать все taint определённой категории. Возможные значения перечисления: - `"Equal"` - `"Exists"`
`tolerationSeconds` integer	TolerationSeconds задаёт период времени, в течение которого допуск разрешает taint (он должен иметь эффект NoExecute, иначе это поле игнорируется). По умолчанию поле не задано, что означает бессрочный допуск taint (без вытеснения). Система рассматривает нулевые и отрицательные значения как 0 (немедленное вытеснение). Если значение больше нуля, время, когда Pod должен быть вытеснен, вычисляется как \ + \.
`value` string	Value — это значение taint, которому соответствует допуск. Если оператор имеет значение Exists, значение должно быть пустым; в противном случае это обычная строка. Должно быть допустимое значение метки.

ExactDeviceRequest

ExactDeviceRequest — это запрос одного или нескольких одинаковых устройств.

Поле	Описание
`adminAccess` boolean	AdminAccess указывает, что это требование на административный доступ к устройству или устройствам. Предполагается, что требования с AdminAccess будут использоваться для мониторинга или других служб управления устройством. Они игнорируют все обычные требования к устройству в отношении режимов доступа и любых выделений ресурсов. Административный доступ отключён, если это поле не задано или установлено в false; в противном случае он включён.
`allocationMode` string	AllocationMode и связанные с ним поля определяют, как выделяются устройства для выполнения этого запроса. Поддерживаемые значения: - ExactCount: запрос на определённое количество устройств. Это значение по умолчанию. Точное количество указывается в поле count. - All: запрос на все подходящие устройства в пуле. Чтобы выделение прошло успешно, на узле должно существовать хотя бы одно устройство. Выделение завершится ошибкой, если некоторые устройства уже выделены, кроме случаев, когда запрошен adminAccess. Если AllocationMode не задан, по умолчанию используется режим ExactCount. Если выбран режим ExactCount и count не задан, по умолчанию используется значение один. Для любых других запросов это поле необходимо указать. В будущем могут быть добавлены другие режимы. Клиенты должны отказываться обрабатывать запросы с неизвестными режимами. Возможные значения перечисления: - `"All"` - `"ExactCount"`
`capacity` CapacityRequirements	Capacity определяет требования к ресурсам для каждой ёмкости. Если это поле не задано и устройство поддерживает несколько выделений, к каждой ёмкости будет применено значение по умолчанию в соответствии с requestPolicy. Для ёмкости, у которой нет requestPolicy, по умолчанию используется полное значение ёмкости. Применяется к каждому выделению устройства. Если Count > 1, запрос завершится ошибкой, если недостаточно устройств, отвечающих требованиям. Если AllocationMode установлен в All, запрос завершится ошибкой, если существуют устройства, которые в остальном соответствуют запросу и имеют эту ёмкость со значением >= запрошенного, но не могут быть выделены для этого запроса.
`count` integer	Count используется только в режиме подсчёта "ExactCount". Значение должно быть больше нуля. Если AllocationMode установлен в ExactCount, а это поле не задано, по умолчанию используется значение один.
`deviceClassName` * string	DeviceClassName ссылается на конкретный DeviceClass, который может определять дополнительные конфигурации и селекторы, наследуемые этим запросом. DeviceClassName обязателен. Администраторы могут использовать его, чтобы ограничить устройства, которые можно запрашивать, устанавливая только классы с селекторами для разрешённых устройств. Если пользователи могут запрашивать любые устройства без ограничений, администраторы могут создать пустой DeviceClass, на который пользователи будут ссылаться.
`selectors` массив DeviceSelector	Selectors задают критерии, которым должно соответствовать конкретное устройство, чтобы его можно было рассматривать для этого запроса. Чтобы устройство считалось подходящим, должны выполняться все селекторы.
`tolerations` массив DeviceToleration	Если задано, это допуски запроса. Для выделения устройства с эффектом taint NoSchedule необходимо указать соответствующий допуск. То же относится к NoExecute. Кроме того, если после выделения на любом из выделенных устройств появится taint NoExecute, а этот эффект не будет допущен, все поды, использующие ResourceClaim, будут удалены, чтобы выселить их. Планировщик не позволит новым подам зарезервировать требование, пока на устройствах есть такие taint. После выселения всех подов выделение требования будет отменено. Максимальное количество допусков — 16. Это поле находится в бета-версии и требует включения функционального переключателя DRADeviceTaints.

NetworkDeviceData

NetworkDeviceData содержит сведения о сети для выделенного устройства. Эти сведения могут заполняться драйверами или другими компонентами для настройки устройства или его идентификации в сетевом контексте.

Поле	Описание
`hardwareAddress` string	HardwareAddress — это аппаратный адрес (например, MAC-адрес) сетевого интерфейса устройства. Длина не должна превышать 128 байт.
`interfaceName` string	InterfaceName задаёт имя сетевого интерфейса, связанного с выделенным устройством. Это может быть имя физического или виртуального сетевого интерфейса, настраиваемого в поде. Длина не должна превышать 256 байт.
`ips` string array	IPs содержит сетевые адреса, назначенные сетевому интерфейсу устройства. Сюда могут входить адреса IPv4 и IPv6. IP-адреса указаны в нотации CIDR, включающей адрес и соответствующую маску подсети. Например: "192.0.2.5/24" для IPv4 и "2001:db8::5/64" для IPv6.

ResourceClaimConsumerReference

ResourceClaimConsumerReference содержит достаточно сведений, чтобы найти потребителя ResourceClaim. Пользователь должен быть ресурсом в том же пространстве имён, что и ResourceClaim.

Поле	Описание
`apiGroup` string	APIGroup — это группа ресурса, на который выполняется ссылка. Для основного API значение пустое. Она соответствует группе в APIVersion, используемой при создании ресурсов.
`name` * string	Name — это имя ресурса, на который выполняется ссылка.
`resource` * string	Resource — это тип ресурса, на который выполняется ссылка, например "pods".
`uid` * string	UID однозначно идентифицирует одну конкретную инкарнацию ресурса.

© 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-claim-v1/