你正在查看的文档所针对的是 Kubernetes 版本: v1.28
Kubernetes v1.28 版本的文档已不再维护。你现在看到的版本来自于一份静态的快照。如需查阅最新文档,请点击 最新版本。
ResourceClaim v1alpha2
apiVersion: resource.k8s.io/v1alpha2
import "k8s.io/api/resource/v1alpha2"
ResourceClaim
ResourceClaim 描述资源使用者需要哪些资源。它的状态跟踪资源是否已被分配以及产生的属性是什么。
这是一个 Alpha 级别的资源类型,需要启用 DynamicResourceAllocation 特性门控。
apiVersion: resource.k8s.io/v1alpha2
kind: ResourceClaim
metadata (ObjectMeta)
标准的对象元数据。
spec (ResourceClaimSpec),必需
spec 描述了需要被分配的资源所需的属性。它只能在创建 ResourceClaim 时设置一次。
status (ResourceClaimStatus)
status 描述资源是否可用以及具有哪些属性。
ResourceClaimSpec
ResourceClaimSpec 定义资源如何被分配。
resourceClassName (string),必需
resourceClassName 通过部署驱动时创建的 ResourceClass 名称来引用驱动和附加参数。
allocationMode (string)
分配可以立即开始或在 Pod 想要使用资源时开始。"WaitForFirstConsumer" 是默认值。
parametersRef (ResourceClaimParametersReference)
parametersRef 引用一个单独的对象,包含驱动为申领分配资源时将使用的任意参数。
此对象必须与 ResourceClaim 在同一个名字空间中。
ResourceClaimParametersReference 包含足够信息,便于你定位 ResourceClaim 的参数。 该对象必须与 ResourceClaim 在相同的名字空间中。
parametersRef.kind (string),必需
kind 是所引用资源的类别。这个值与参数对象元数据中的值相同,例如 "ConfigMap"。
parametersRef.name (string),必需
name 是所引用资源的名称。
parametersRef.apiGroup (string)
apiGroup 是所引用资源的组。对于核心 API 而言此值为空。 字段值与创建资源时所用的 apiVersion 中的组匹配。
ResourceClaimStatus
ResourceClaimStatus 跟踪资源是否已被分配以及产生的属性是什么。
allocation (AllocationResult)
一旦某资源或资源集已被成功分配,资源驱动就会设置 allocation 的值。 如果此项未被设置,则表示资源尚未被分配。
allocation.availableOnNodes (NodeSelector)
在资源驱动完成资源分配之后,将设置此字段以通知调度器可以将使用了 ResourceClaim 的 Pod 调度到哪里。
设置此字段是可选的。如果字段值为空,表示资源可以在任何地方访问。
节点选择算符表示对一组节点执行一个或多个标签查询的结果的并集; 也就是说,它表示由节点选择算符条件表示的选择算符的逻辑或计算结果。
allocation.availableOnNodes.nodeSelectorTerms ([]NodeSelectorTerm),必需
必需。节点选择算符条件的列表。这些条件以逻辑或进行计算。
一个 null 或空的节点选择算符条件不会与任何对象匹配。条件中的要求会按逻辑与的关系来计算。 TopologySelectorTerm 类别实现了 NodeSelectorTerm 的子集。
allocation.availableOnNodes.nodeSelectorTerms.matchExpressions ([]NodeSelectorRequirement)
基于节点标签所设置的节点选择算符要求的列表。
allocation.availableOnNodes.nodeSelectorTerms.matchFields ([]NodeSelectorRequirement)
基于节点字段所设置的节点选择算符要求的列表。
allocation.resourceHandles ([]ResourceHandle)
原子性:将在合并期间被替换
resourceHandles 包含应在申领的整个生命期中保持的、与某资源分配所关联的状态。 每个 resourceHandle 包含应向特定 kubelet 插件传递的数据, 一旦资源落到某具体节点上,这些数据就会被传递给该插件。 此数据将在成功分配后由驱动返回,并对 Kubernetes 不透明。 必要时驱动文档可能会向用户阐述如何解读这些数据。
设置此字段是可选的。它最大可以有 32 个条目。如果为 null(或为空), 则假定此分配将由某个确定的 kubelet 插件处理, 不会附加 resourceHandle 数据。所调用的 kubelet 插件的名称将与嵌入此 AllocationResult 的 ResourceClaimStatus 中设置的 driverName 匹配。
resourceHandle 保存不透明的资源数据,以供特定的 kubelet 插件处理。
allocation.resourceHandles.data (string)
data 包含与此 resourceHandle 关联的不透明数据。 data 由资源驱动中的控制器组件设置,该驱动的名字与嵌入此 resourceHandle 的 ResourceClaimStatus 中设置的 driverName 相同。 data 在分配时进行设置,供 kubelet 插件处理;所指的插件的名称与此 resourceHandle 所设置的 driverName 相同。
该字段的最大值为 16KiB。此值在未来可能会增加,但不会减少。
allocation.resourceHandles.driverName (string)
driverName 指定资源驱动的名称;一旦 resourceHandle 落到某具体节点, 就应调用该驱动对应的 kubelet 插件来处理此数据。 字段值可能与嵌入此 resourceHandle 的 ResourceClaimStatus 中设置的 driverName 不同。
allocation.shareable (boolean)
shareable 确定资源是否同时支持多个使用者。
deallocationRequested (boolean)
deallocationRequested 表示某 ResourceClaim 将被取消分配。
出现请求后,驱动必须释放此申领,重置此字段并清除 allocation 字段。
在 deallocationRequested 被设置时,不能将新的使用者添加到 reservedFor。
driverName (string)
driverName 是在确定了分配之后,从 ResourceClass 复制而来的驱动名称。
reservedFor ([]ResourceClaimConsumerReference)
Map:合并期间根据键 uid 保留不重复的值
reservedFor 标明目前哪些实体允许使用申领。如果引用未为某个 Pod 预留的 ResourceClaim,则该 Pod 将不会启动。
最多可以有 32 个这样的预留。这一限制可能会在未来放宽,但不会减少。
ResourceClaimConsumerReference 包含足够的信息以便定位 ResourceClaim 的使用者。 用户必须是与 ResourceClaim 在同一名字空间中的资源。
reservedFor.name (string),必需
name 是所引用资源的名称。
reservedFor.resource (string),必需
resource 是所引用资源的类别,例如 "pods"。
reservedFor.uid (string),必需
uid 用于唯一标识资源的某实例。
reservedFor.apiGroup (string)
apiGroup 是所引用资源的组。对于核心 API 而言此值为空。 字段值与创建资源时所用的 apiVersion 中的组匹配。
ResourceClaimList
ResourceClaimList 是申领的集合。
apiVersion: resource.k8s.io/v1alpha2
kind: ResourceClaimList
metadata (ListMeta)
标准的列表元数据。
items ([]ResourceClaim),必需
items 是资源申领的列表。
操作
get
读取指定的 ResourceClaim
HTTP 请求
GET /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaims/{name}
参数
响应
200 (ResourceClaim): OK
401: Unauthorized
get
读取指定 ResourceClaim 的状态
HTTP 请求
GET /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaims/{name}/status
参数
响应
200 (ResourceClaim): OK
401: Unauthorized
list
列出或监视 ResourceClaim 类别的对象
HTTP 请求
GET /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaims
参数
namespace(路径参数):string,必需
allowWatchBookmarks(查询参数):boolean
continue(查询参数):string
fieldSelector(查询参数):string
labelSelector(查询参数):string
limit(查询参数):integer
pretty(查询参数):string
resourceVersion(查询参数):string
resourceVersionMatch(查询参数):string
sendInitialEvents(查询参数):boolean
timeoutSeconds(查询参数):integer
watch(查询参数):boolean
响应
200 (ResourceClaimList): OK
401: Unauthorized
list
列出或监视 ResourceClaim 类别的对象
HTTP 请求
GET /apis/resource.k8s.io/v1alpha2/resourceclaims
参数
allowWatchBookmarks(查询参数):boolean
continue(查询参数):string
fieldSelector(查询参数):string
labelSelector(查询参数):string
limit(查询参数):integer
pretty(查询参数):string
resourceVersion(查询参数):string
resourceVersionMatch(查询参数):string
sendInitialEvents(查询参数):boolean
timeoutSeconds(查询参数):integer
watch(查询参数):boolean
响应
200 (ResourceClaimList): OK
401: Unauthorized
create
创建 ResourceClaim
HTTP 请求
POST /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaims
参数
namespace(路径参数):string,必需
body: ResourceClaim,必需
dryRun(查询参数):string
fieldManager(查询参数):string
fieldValidation(查询参数):string
pretty(查询参数):string
响应
200 (ResourceClaim): OK
201 (ResourceClaim): Created
202 (ResourceClaim): Accepted
401: Unauthorized
update
替换指定的 ResourceClaim
HTTP 请求
PUT /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaims/{name}
参数
name(路径参数):string,必需
ResourceClaim 的名称。
namespace(路径参数):string,必需
body: ResourceClaim,必需
dryRun(查询参数):string
fieldManager(查询参数):string
fieldValidation(查询参数):string
pretty(查询参数):string
响应
200 (ResourceClaim): OK
201 (ResourceClaim): Created
401: Unauthorized
update
替换指定 ResourceClaim 的状态
HTTP 请求
PUT /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaims/{name}/status
参数
name(路径参数):string,必需
ResourceClaim 的名称。
namespace(路径参数):string,必需
body: ResourceClaim,必需
dryRun(查询参数):string
fieldManager(查询参数):string
fieldValidation(查询参数):string
pretty(查询参数):string
响应
200 (ResourceClaim): OK
201 (ResourceClaim): Created
401: Unauthorized
patch
部分更新指定的 ResourceClaim
HTTP 请求
PATCH /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaims/{name}
参数
name(路径参数):string,必需
ResourceClaim 的名称。
namespace(路径参数):string,必需
body: Patch,必需
dryRun(查询参数):string
fieldManager(查询参数):string
fieldValidation(查询参数):string
force(查询参数):boolean
pretty(查询参数):string
响应
200 (ResourceClaim): OK
201 (ResourceClaim): Created
401: Unauthorized
patch
部分更新指定 ResourceClaim 的状态
HTTP 请求
PATCH /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaims/{name}/status
参数
name(路径参数):string,必需
ResourceClaim 的名称。
namespace(路径参数):string,必需
body: Patch,必需
dryRun(查询参数):string
fieldManager(查询参数):string
fieldValidation(查询参数):string
force(查询参数):boolean
pretty(查询参数):string
响应
200 (ResourceClaim): OK
201 (ResourceClaim): Created
401: Unauthorized
delete
删除 ResourceClaim
HTTP 请求
DELETE /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaims/{name}
参数
name(路径参数):string,必需
ResourceClaim 的名称。
namespace(路径参数):string,必需
body: DeleteOptions
dryRun(查询参数):string
gracePeriodSeconds(查询参数):integer
pretty(查询参数):string
propagationPolicy(查询参数):string
响应
200 (ResourceClaim): OK
202 (ResourceClaim): Accepted
401: Unauthorized
deletecollection
删除 ResourceClaim 的集合
HTTP 请求
DELETE /apis/resource.k8s.io/v1alpha2/namespaces/{namespace}/resourceclaims
参数
namespace(路径参数):string,必需
body: DeleteOptions
continue(查询参数):string
dryRun(查询参数):string
fieldSelector(查询参数):string
gracePeriodSeconds(查询参数):integer
labelSelector(查询参数):string
limit(查询参数):integer
pretty(查询参数):string
propagationPolicy(查询参数):string
resourceVersion(查询参数):string
resourceVersionMatch(查询参数):string
sendInitialEvents(查询参数):boolean
timeoutSeconds(查询参数):integer
响应
200 (Status): OK
401: Unauthorized